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6.1 

6-3 

01 6X 

SQP 

5.2.1 

08A8* 

LAM 
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5.5.4 







04XX 
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5.5.3 







05XX 

IIN 

5.5.3 







06XX 

SPB 

5. 5.2 







07XX 

CPB 

5.5.2 







09XX 

INA 

5.5.1 







OAXX 
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5. 5.1 







OBXX 

NOP 

5. 5.5 







OCXX 

ENQ 

5. 5.1 







ODXX 
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5. 5.1 







OEXX 

EXI 

5.5.3 





*Right most Hex number will include destination register. 

**Third Hex number will include uppermost bit of shift count (bit 4). 
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INTRODUCTION 

The CONTROL DATA 1704 Computer is a stored program, digital computer. Physically 
small, it is designed for high computation and input/ output (I/O) speed. The program pro- 
tection features of the 1704 Computer and high reliability under a wide range of environmental 
conditions make it suitable for real-time, on-line, or control applications. 

The interface of the 1700 Computer System is capable of accepting a great variety of peripheral 
devices. Refer to Figure 1 for system characteristics. 


Figure 1. 1700 Computer System Characteristics 


Stored program, digital computer 

Reliability (calculated) : 

Completely solid- state, 6000-type logic 

Approximately 8,000 hours 
mean time between failures for 

Parallel modes of operation 

the 1704 Computer 

18-bit storage word 

Environment: 

16 data bits 

40° F to 120° F 

1 parity bit 

Relative humidity 0% to 80% 

1 program protect bit 

Cooling: Forced Air 

16-bit instruction word 

System Interrupt 

Two 16-bit index registers 

Flexible repertoire of instructions: 

Multilevel indirect addressing 

Arithmetic operations 

Magnetic core storage (options available) : 

Logical and masking opera- 
tions 

Interregister transfers 

4096 18-bit words, expandable to 
32,768 words 

Input/Output (options available): 

Base 16 (hexadecimal) number sys- 
tem 

Transmission of 16-bit words or 8-bit 

characters 

Binary arithmetic: 

Console includes: Register contents dis- 

Modulus 2-1 (one's comple- 
ment) 

played in binary; operating switches 

and indicators 

Intercomputer communications: 


1700 to 1700 
Satellite operations 


1.1 MEMORY 

The basic 1700 Computer System provides high-speed, random-access magnetic core 
storage for 4,096 18-bit words. The storage capacity may be expanded from 4K by 4K 
increments to 32K as a maximum. With the addition of special hardware, memory may 
be doubled from 32K to 64K. 



® Registered trademark of Control Data Corporation 
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storage cycle time is 1.1 microseconds. This is defined as the shortest possible time 
between successive Read/Write operations in storage. 


A storage word may be a 16-bit instruction, a 16-bit operand or a 16-bit address. A 
parity bit and a program protect bit are appended to each 16-bit storage word; thus a 
storage word is 18 bits long. Format: 


17 16 15 


Bit 


0 



I ^Parity Bit 
^Program Protect Bit 



-Bit Data or Instruction Word 


Bit 16 is the parity bit. It takes on a value so that the total number of 1 bits is odd (total 
number of bits includes the program protect bit). For example, if all 16 data bits are I’s 
and the program protect bit is 0, the parity bit is a 1. 

Bit 17 is the program protect bit. If it is a one, the word is protected and can only be 
modified or changed by a protected instruction. 

1.2 PROTECT SYSTEM 

The program protect system in the 1700 makes it possible to protect a program in the 
computer from any other non-protected program also in the computer. The combination 
of the high internal memory speed and the program protect system makes possible the 
use of the 1700 for background and foreground work. Foreground programs are protected 
and are generally multi-level (level 2 to 15) process programs. The foreground job is 
protected in core and runs at higher priority than background jobs which are assemblies, 
compilations, programs being debugged, etc. The background programs use the time 
available and are run in unprotected core. The protect system is enabled by setting the 
program protect switch on the programmer’s panel. Any attempt to violate in any manner 
the protected portion of core from an unprotected instruction will cause a program pro- 
tect violation which sets an interrupt on line 0 and also the program protect indicator 
which is visible as one of the fault lines on the programmer’s panel. There are four pro- 
gram protect violations. They are: 

1. An attempt is made by a non-protected instruction to write into a storage location 
containing a protected instruction or operand. It is legal to read from a protected 
area. 

2. An attempt is made to write into a protected storage location by way of the ex- 
ternal storage access when a non-protected instruction was the ultimate source of 
the attempt. 

3. An attempt is made to execute a protected instruction following the execution of a 
non-protected instruction. 
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4. An attempt is made to execute interregister class instructions with bit 0 a one (M 
register is the destination); instructions EIN, IIN, EXI, SPB, or CPB. Later ex- 
amination of these instructions will show how these are used to change the state of 
interrupts or the protected core area itself. 

1. 3 INTERRUPT SYSTEM 

The basic computer (1704) provides two interrupt lines. Line 0 provides entry for inter- 
rupts generated as a result of a storage parity error, a program protect fault, or power 
failure. There are instructions available for the processing program to check for parity 
error or protect fault, and power failure can be assumed if one of the other two conditions 
does not exist, hi the case of power failure, approximately 8 milliseconds of program- 
ming time are available; then the computer generates a master clear before the power 
actually goes down. Special hardware is available which can generate an automatic 
restart after the power comes back up. 

Line 1 provides for interrupts from the low-speed peripherals controlled by Equipment #1, 
the slow channel synchronizer. Any of the four stations (TTY, Card Reader, Paper Tape 
Reader, Paper Tape Punch) on the slow channel synchronizer sends its interrupt to line 1. 

The 1705 provides expansion from two interrupt lines to 16 interrupt lines, to provide 
for additional equipment. 

Interrupts are controlled by an interrupt mask register (M Register, 16 bits) which either 
allows selected interrupts in or blocks them out. Each line corresponds to its bit in the 
M Register. If the bit is a 0, any interrupt on that line is blocked out and must wait; if 
the bit is a 1, the interrupt is allowed in. The mask in the M register is set and changed 
under program control. Priority is established by the mask in the M register, not by 
the line position. In the case of concurrent interrupts on more than one line at the same 
priority, the lowest numbered line is recognized first. 

There is a fixed group of core locations assigned to the iuterrupt system, locations 
$1G0-$13F, called the Interrupt Trap area. Four core locations are reserved for each 
line, beginning at $100 for line 0; each 4-word block is called the "trap" for that line. 
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Figure 2. 1700 Interrupt Trap Area 



LINE 15 TRAP 


LINE 1 TRAP 


LINE 0 TRAP 


Contents of Trap; 

word 3 - address of interrupt processor 
word 2 - priority level for line 
word 1 - RTJ to interrupt handler 
word 0 - overflow and P 


If the interrupt system is enabled and an interrupt occurs on a line that has a corre- 
sponding 1 in the M register, the hardware does the following: 


1. disables the interrupt system (locks out all interrupts), 





2. saves the contents of the P register (the address of the next instruction which 
would have been executed in the interrupted program) in the first word of the trap 
for that line, 

3. saves the state of the overflow indicator (1 if set, 0 if not set) in bit 15 of that 
same word, 


4. transfers control to the second word in the trap. 


The above is adl that the hardware does in handling an interrupt; anything else must be 
done by the software. Under most systems, the second word of the trap for each line is 
initialized by the software to contain a jump out of the trap to a routine (or routines) to 
save the registers of the interrupted program and handle the interrupt. The third and 
fourth words of each trap can be used by the software to contain anything desired; the 
standard operating system uses these words to hold the priority level of the line and the 
address of the processing program for the line, respectively. The interrupt processing 
routine may exit interrupt state (back to the interrupted program) through word 0 of the 
corresponding trap. 

Example ; 

Assume line 1 has high priority, line 3 has lower priority. Line 0 always has highest 

priority. Any other running program has lower priority than either line 0, 1, or 3. 
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Make a table containing M register masks to be used while the routine servicing each 
line is running: 


bit — 
MASKM 
MASKS 
MASKl 
MASKO 


15 


0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

1 

0 

1 

1 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

1 

1 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

1 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 


mask for main program 
mask for line 3 
mask for line 1 
mask for line 0 


Note that MASKM will allow all pertinent lines to interrupt; MASKS will allow line 1 or 
line 0 to interrupt; MASKl will allow only line 0 to interrupt; MASKO will not allow any 
line to interrupt. 

The processing programs would be set up as follows: 

Main Program 

Set M register to MASKM 

Enable interrupt system 


End 


Interrupt Processor for Line 3 
Store A, Q, I, M registers 
Set M register to MASKS 
Enable interrupt system 

Inhibit interrupts 
Restore registers 
Exit interrupt state 03 

Interrupt Processor for Line 1 
Store A, Q, I, M registers 
Set M register to MASKl 
Enable interrupt system 

Inhib i J inte r rupts 
Restore registers 
Exit interrupt state 01 
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Interrupt Processor for Line 0 

could just leave interrupts locked 
out during execution as shown here 
rather than set new mask (mask 
would be MASKO if set and inter- 
rupts enabled) 

Chapter 4 of the Computer Reference Manual contains more details about the Interrupt 
System. 

1. 4 INPUT/OUTPUT 

Included with the 17 04 is a slow channel synchronizer. This channel handles any or all 
of the slow speed devices normally affixed to a 1704. These are the 1713 Teletype, the 
1729 Card Reader, the 1721 Paper Tape Reader, and the 1723 Paper Tape Punch. * Fig- 
ure 2 shows a data pack extending from these slow speed devices through the slow channel 
synchronizer to both the A and Q registers. Transfer of information to these devices 
then is one word at a time (unbuffered) with the Q register containing address information 
and the A register containing data. The addition of a 1705 to the 1704 extends the A/Q 
unbuffered channel to eight more equipments. The 1705 also provides the addition of a 
direct access bus (DAC) to core. This provides buffered transfer of data directly to or 
from memory, bypassing the registers in the computer and, in fact, bypassing the normal 
compute channel of the computer. This direct access allows high speed transfer of data 
from peripheral devices like discs, drums, mag tapes, or high speed industrial equip- 
ment like multiplexers, etc. 

1. 5 BASIC SYSTEM DESCRIPTION 

Figure 2 illustrates the basic structure of the 1704 and also extension to peripherals 
through the addition of a 1705. The basic 1704 is supplied with 4K (4096 words) of core 
storage. Core can be expanded in 4K increments to a maximum of 32K (or to 64K with 
the addition of special hardware). 

1. 5. 1 Registers 

There are four registers that the programmer can get to directly from instruc- 
tions. These registers are the A, Q, I, and M registers. 

The A Register is the principal arithmetic register. It contains 16 bits (labeled 
bit-0 up to bit- 15) of which bit- 15 is the sign bit for arithmetic operations. The 
A register is also the register used to interface data during input/output oper- 
ations to peripheral equipment. 


Store A, Q, I, M registers 


Exit interrupt state 00 


*Also the variations of these (1711, 1713, 1 1722, 1724). 
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Figure 3. Basic System Description 
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The Q Register is a multi-use register. Its uses include: 

a. Auxiliary arithmetic register. 

b. Retains part of the result of arithmetic operations such as multiply or divide. 

c. Retains the most significant portion of the dividend during divide operations. 

d. The Q Register is also used as the primary index register for address modi- 
fication. 

e. The Q Register supplies the addressing for peripheral equipments during 
unbuffered input/ output operations. 

The I Register is the second index register available. It is actually core location 
OOFF^g. 

The M Register or Mask Register controls interrupts. A one bit in any position 
of the mask register wdl enable an interrupt from the corresponding line number 
while a zero in any bit position of the mask register blocks the interrupt from the 
corresponding line number. The mask register is effective in controlling inter- 
rupts only when the interrupt system is enabled. 

Other registers of interest to the programmer are: 

P Register: This 15-bit register functions as the program address counter. It 
holds the address of each instruction, and after executing the instruction at address 
P, P is advanced to the address of the next instruction. The amount by which P 
is advanced is determined by the type of instruction being executed. 

X Register : The X register is an exchange register containing 16 bits. This 
register holds data going to or from memory. It also holds one of the parameters 
in most arithmetic operations. 

Y Register: The Y register is an address register containing 16 bits. It is in this 
register that storage addresses are formed and held for transfer during a storage 
reference. 

The A, Q, M, X, Y and P Registers can be displayed and entered on the program- 
mer’s panel. 

Shifter: The shifter is used by multiply, divide, and shift instructions. It is 
capable of shifting the output of the adder left and right one binary position or 
giving a direct transfer path to the arithmetic registers. 

Adder: A 16-bit adder is used to perform all arithmetic and address calculations. 
Inputs to the adder are shown through the gates. The adder is a one’s complement 
subtractive adder which is more fully described in the next chapter, 

F Register: This 8-bit register is used by the control section of the 1704 for de- 
coding instructions. 
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Z Register; This register communicates between the actual core storage and the 
computer through the X register. Notice this is an 18-bit register; the lower 16 
bits are data or instructions from core, the 17th bit or bit #16 is the parity bit 
and the high order bit or bit #17 is the program protect bit. Core storage is 
described more fully in the next section. 

S Register; This 15-bit register which is fed from the Y register is used to 
directly address core storage. Since core storage has a maximum of 32K loca- 
tions, the S register need only be 15 bits. 

The Z register and the S register are connected directly to external equipment 
through the 1705. This direct access channel allows insertion or extraction of 
core data directly to peripherals without program intervention. 

Refer to Reference 1, Appendix A, for a more detailed description of the reg- 
isters. 
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1.7 CONSOLE DESCRIPTION 
SWITCHES 

Master Clear This is a three-position key/Iever switch. A Master Clear is 

executed whenever it is momentarily operated either up or down. 
A Master Clear returns the computer and peripheral devices to 
initial conditions by clearing all registers and peripheral equip- 
ment logic. 

Run/ Step This is a three-position key/lever switch. When the switch is 

momentarily placed in the RUNposition, the computer begins pro- 
gram execution, starting with the instruction whose address is in 
the P register. The computer is stopped by momentarily placing 
the switch in the STEP position. 

If the switch is repeatedly placed in the STEP position, the com- 
puter steps through the program, stopping after each storage 
reference. The significance of the storage reference just made 
is indicated by the Instruction Sequence indicators (INSTRUCTION, 
IND IRE C T ADDRE SS, et c . ) . 

Enter/ Sweep This is a three-position key/lever switch maintained in all posi- 

tions. The center position is off. Enter is used to enter memory; 
sweep is used to examine the contents of memory. 

Enter 

The ENTER position selects the Enter mode. In this mode, each 
Step operation of the RUN/STEP switch stores the contents of the 
X register at the location specified by P + 1 and then advances the 
P register by one. The first step after a Master Clear or clear 
P stores the contents of the X register at the location specified 
by P. 

To store a few instructions in unprotected storage, proceed as 
follows: 

1) Power is on but computer is stopped. 

2) Operate Master Clear switch. 

3) Press P REGISTER SELECT switch and CLEAR pushbutton, 
in that order. Set desired address for instruction In P by use 
of indicator pushbuttons. 

4) Set ENTER/SWEEP switch to ENTER. 

5) Press X REGISTER SELECT switch. 
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Selective Stop 


Selective Skip 


Program Protect/ 
Test Mode 


6) Press CLEAR pushbutton, then enter word to be stored by use 
of indicator pushbuttons. 

7) Move run/step switch to STEP one time (carefully). 

To store additional words in successive storage locations, repeat 
steps 6 and 7 until finished. To change to a new sequence of 
addresses, start at step 2 for the first one, then repeat steps 6 
and 7 for each successive word. 

A lighted indicator pushbutton indicates a "1", a dark one a "0". 
Sweep 

The SWEEP position selects the Sweep mode. In this mode, each 
operation of the RUN/STEP switch displays in the X register the 
contents of the storage location whose address is P + 1. The P 
register is advanced by one after each Step operation. The first 
step after a Master Clear or clear P displays the location speci- 
fied by P. Instructions are not executed. 

This is a three-position key/lever switch. The computer stops 
when it executes a Selective Stop instruction if this switch is in 
either the up or down position. The up position is maintained; 
the down position is momentary. 

This is a three-position key/lever switch. Two Selective Skip 
instructions (SWS and SWN) are conditioned by this switch. This 
switch is off in the center position; the up position is maintained; 
the down position is momentary. 

This is a three-position key/lever switch maintained in all posi- 
tions. The center position is off. 


Program Protect 

The PROGRAM PROTECT position selects program protection. 
Test Mode 

The TEST MODE position selects Test mode. This is used by 
the customer engineers for maintenance. 


Emergency Off 


Pressing this switch shuts off power for the entire system. 



Register Select 


INDICATORS 
Program Protect 

Faults 


Instruction Sequence 
Indicators 


The M, P, Y, X, A, and Q registers are available for display and 
manual entry of values via switch/indicators. A six- pushbutton 
switch/indicator, REGISTER SELECT, selects the register for 
display and entry. 

Push the button for the desired register, and the contents of that 
register will light up in the 16-bit console binary register. A 
button lighted indicates a 1 bit; unlighted, a 0 bit. 

If it is des ired to change the contents of the register, push the 
CLEAR button (not Master Clear switch) to clear out that register. 
Then set the new contents in the register by pushing the button 
(it will light up when pushed) for each bit that should be a 1 bit in 
the register. 


The PROGRAM PROTECT bit indicator displays the state of the 
program protect bit of the last storage location referenced by the 
computer. 

There are five fault indicators. When lighted, the fault condition 
is present. 

• HI TEMP The temperature inside the computer has ex- 
ceeded safe operating limits. 

• TEMP WARN The ambient air temperature is approaching 
the maximum safe operating limit. 

• OVERFLOW An arithmetic register overflow has occurred. 

• PROGRAM PROTECT A violation of the program protect 
system has been detected. 

• STORAGE PARITY A parity error has been detected in an 
operand or instruction read from storage. 

When an instruction is being stepped, this group of four indicators 
describe the meaning of the storage reference just completed. 
The data of the storage reference (read or write) is in the X reg- 
ister. The four indicators and their meaning when lighted are: 

• INSTRUCTION; The contents of theX register is an instruc- 
tion. 
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• INDIRECT ADDRESS: The contents of the X register is the 
result of indirect addressing. The indirect address may also 
be another indirect address, hence, this indicator may re- 
main lighted for several consecutive storage references. 

• STORAGE INDEX; The contents of the X register is the value 
of the Storage Index register. 

• OPERAND: The contents of theX register is the value of the 
operand either written into or read from storage. 

If more than one Instruction Sequence indicator is lighted, the 
computer is running. If only one indicator is lighted, the com- 
puter is not running or is in a rather unlikely program loop which 
does not use operands, the storage index, or indirect addressing. 
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CHAPTER II - 1700 Arithmetic 
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Figure 6. Numbers 

Decimal Octal Binary Hexadecimal 



0 

0 

0 

0 


1 

1 

1 


1 


2 

2 

10 


2 


3 

3 

11 


3 


4 

4 

100 


1 


5 

5 

101 

1 

5 


6 

6 

110 

6 


7 

7 

111 

r 

7 


8 

10 

1000 

8 


9 

11 

1001 

9 

10 

12 

1010 

A 

11 

13 

1011 

B 

12 

14 

1100 

C 

13 

15 

1101 

D 

14 

16 

1110 

E 

15 

17 

nil 

F 

16 

20 

10000 

10 

HEX-DEC CONVERSIONS 




Since the 1700 is a 16 

-bit machine, it is 

convenient to group the 16 binary bits into 4 

hexadecimal digits. 

This allows for quicker and easier manipulation of the arithmetic 

and easier identification of program dumps. The relationship of the 4 binary bits to each 

hexadecimal digit and the decimal equivalent is shown below: 




15 14 13 12 

11 10 9 8 

7 6 5 4 

3 2 10 


r 







Hs 

«2 

Hi 

Ho 



16 Bit 1700 Machine Word 
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The Range of Binary Bits in Each HEX Position Is: 


Binary 

HEX 

Decimal 

Binary 

HEX 

Decimal 

0000 

0 

0 

1000 

8 

8 

0001 

1 

1 

1001 

9 

9 

0010 

2 

2 

1010 

A 

10 

0011 

3 

3 

1011 

B 

11 

0100 

4 

4 

1100 

C 

12 

0101 

5 

5 

1101 

D 

13 

0110 

6 

6 

1110 

E 

14 

0111 

7 

7 

1111 

F 

15 


This table must be memorized. 

The arithmetic operations that are essentially basic involve binary to HEX, HEX to bi- 
nary, hexadecimal to decimal, decimal to hexadecimal conversion, taking the one’s 
complement of a hexadecimal number, and adding and subtracting hexadecimal numbers. 

Each hexadecimal digit represents by its position in the number a certain power of the 
base 16. The least significant digit is a multiple of 16^ which is 1; the second least 
significant digit represents a multiple of IG^ which is 16; the third least significant digit 
represents a multiple of 16^ which is 256; and the most significant hexadecimal digit 
represents a multiple of 16 3 which is 4096. It is necessary then only to do these multi- 
plications followed by a final addition of the four multiples in order to convert a hexa- 
decimal number to the decimal equivalent. 

Example: Convert 13ED]^0 to Decimal. 

D X 16® = 13 X 1 = 13 

E X 16^ = 14 X 16 = 224 

3 X 16^ = 3 X 256 = 768 

1 X 16^ = lx 4096 = 4096 

Sum 5101jLQ 

There are many methods of converting a decimal number to hexadecimal. The simplest 
method involves successive divisions of the decimal number by 16. Each remainder be- 
comes in turn the least significant hexadecimal digit of the converted answer, while each 
quotient becomes the next decimal number to be divided. Divisions continue until the 
quotient becomes zero. 


Example: Convert 1476 -j^q to HEX. 

92 - Continue division 
16 1 1476 

144 


36 

4 - First remainder is Hq=4 
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\ 5 - Continue division 

O ^ 16 1 92 

80 

12 - Second remainder is H2^=C 

0 - Division stops 
16 I 5 
0 

5 - Third remainder is H2=5 
ANSWER - 1476io = 5C4]^g 

Addition of hexadecimal numbers is straightforward. Notice that 16 is carried from the 
least significant position to the most. The subtracting, of course, is the opposite of ad- 
dition with 16 being borrowed from the most significant position. 

Example: Add the HEX numbers 13CE and 2AA7. 


E (14) + 7 = 21 - Carry 16-Excess 5 

C (12) + A(10) +1 = 23 - Carry 16-Excess 7 

3 + A(10) +1 = 14 - No Carry-Excess E 

1 +2 = 3 - No Carry-Excess 3 

As we'll encounter shortly, negative numbers in the 1700 are carried in one's complement 
form. The subtraction in each position of a digit from the largest possible digit in the 
base used yields the one's complement of the number. 

Example: Find the One's Complement of the HEX Number 347E. 

Subtract 

FFFF 

347E 

CB8 1 - is One's Complement of 347 E. 

The same result can be obtained by converting both numbers to binary. 

HEX BINARY 

FFFF = 1111 nil nil nil 

347E = 0011 0100 0111 IIKX 

CB81 = 1100 1011 1000 0001 is One's Complement of 

Notice that the one's complement of a binary number has all ones in the binary number 
changed to zeroes, and all zeroes changed to ones, which suggests another method of 
obtaining the one's complement of a number. 


13CE 
+ 2AA7 
3E75 



2-3 



Figure 7. 1700 Integer Numbers 


Example: 



SIGN BIT 

I 


3B7,6= 

0 

000001 

1 1 

0 110 

1 1 

J 

v_ 


_v\ 




_/ 


V 


V 





3 


B 

7 


Negative Numbers 

stored 

in One's Complement Form: 



3B7,6= 


F 

F 


F 

F 



— 

3 


B 

7 




F 

C 


4 

8 





A 





/ 


V 

A/ 


"A 


1 

1 1 

1 1 1000 

100 1 

000 


4 


SIGN BIT 
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2. 2 RANGE OF NUMBERS 

Figure 8 illustrates the range of numbers used in the 1700. The total number of bits 
available is 16 and for arithmetic operations bit #15 will be a zero for positive numbers, 
and a one for negative numbers. For positive numbers, bits 0-14 are in true form. How- 
ever, for negative numbers bits 0-14 are in one’s complement form. Notice there are 
two O’s, a positive zero and a negative zero. 


Positive Numbers-Bit 15 is a 0 - Number is in true form. 


+32,767 

0111 

1111 

1111 

nil 

+32,766 

0111 

1111 

nil 

1110 


• 

• 

• 

• 

Positive 

m 

• 

• 

• 

Numbers 

• 

• 

• 

• 

1 

• 

• 

• 

• 

+1 

0000 

0000 

0000 

0001 

+0 

0000 

0000 

0000 

0000 


-0 

nil 

nil 

nil 

nil 

-1 

nil 

nil 

nil 

1110 


' • 

• 

• 

• 

Negative 

• 

• 

• 

• 

Numbers 

• 

• 

• 

• 

t 

• 

• 

• 

• 

-32,766 

1000 

0000 

0000 

0001 

-32,767 

1000 

0000 

0000 

0000 


Negative Numbers- Bit 15 is a 1 - Number is in One’s 

Complement Form. 


Note: Each Negative Number is Represented as the One’s Complement of its 
Corresponding Positive Number. 


Figure 8. Range of Numbers Used in the 1700^ 
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2.3 ADDER 

A straightforward adder would pose problems in the 1700 in that negative zero in many 
cases would be produced as a result instead of a positive zero. Consider the addition: 

4321 
+ BCDE 

FFFF - Straightforward addition of the positive number 4321 and a negative num- 
ber of the same size, BCDE, yields a correct result of zero, but nega- 
tive zero instead of positive zero. 

Since the skip tests do not recognize negative zero, the adder in the 1700, which is a 
16-bitone’s complement subtractive adder, eliminates minus zero in all but one case. It 
functions by taking the one’s complement of the addend and subtracting this from the 
augend. The same addition as in the above is accomplished: 

Add 

4 3 21 4321 

+ BCDE ►One's Complement — ►4321- ►Now Subtract 

Same Result - 
But +0 

The one case where a minus zero is produced is the case where minus zero is added to 
minus zero. 

Add Subtract 

FFFF FFFF 

+ FFFF ►OOOO 

FFFF (-0) + (-0) = (-0) 

Negative zero can be converted to positive zero by simply adding positive zero to it. 
Add Subtract 


4321 
4321 
^ 0000 




FFFF FFFF 

+ 0000 ►FFFF 

0 0 0 0 (-0) + (+0) = (+0) 

For subtraction, the subtrahend is not complemented, but is subtracted directly from the 
minuend. The only case producing negative zero is (-0) - (+0) = (-0). 

Subtract Directly 

FFFF 

0000 

FFFF 

Page 3-20 of Reference 1, Appendix A, expounds further on conditions causing negative 
zero. 
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4 OVERFLOW 


Overflow in the 1700 is essentially a condition wherein the result of some arithmetic 
operation is too large to fit into its designated register. Overflow can be caused by add 
type operations, by a subtract type operation and by divide, hi a one's complement com- 
puter like the 1700, overflow, when it occurs, sets the overflow indicator which remains 
on until tested. Refer to Figure 8. Notice that overflow will not occur when a positive 
number is added to a negative number since the result will always lie within the range of 
numbers. Adding two positive numbers together or adding two negative numbers together, 
or the equivalent operation (subtracting a negative number from a positive number or 
subtracting a positive number from a negative number), can cause a result which is too 
large to be contained in the A or Q Register. Recovery can be made from add type over- 
flow operations and, in fact, overflow is often a useful tool for accumulating single pre- 
cision numbers into double precision numbers. 


Example: Add 1 to the Largest Possible Number 


7FFF 

Q Q 0 1 ► Complement 

Then Subtract — 

Subtract Borrow 


7FFF Note: If the adder must borrow from 

^FFFE beyond the most significant 

8 0 01 position, it subtracts 1 from 

1 the result. 

8 0 0 0 — i>Answer is now (-7FFF) which is wrong. 


The computer logic will set the overflow indicator when both signs are initially the same 
and a borrow occurs. 


Recovery can be made, however, by accumulating the overflow in a second cell and 
masking out bit- 15 of the first, since bits 0 through 14 remain correct. 

Remember that any add type instruction can cause overflow. This includes ADD, SUB, 
RAO, AAQ, etc. 


Divide overflow will be described in more detail in the storage reference class of instruc- 
tions for the DVI instruction itself. 


2. 5 FLOATING POINT NUMBERS 

Floatingpoint numbers will be of interest to scientific programmers, and since the 
Fortran compiler provides for them, their format will be discussed here. The range is 
.591 X 10“^^ through 1.694 x 10^^. 

Floating point numbers require two words of core and include: one bit, sign of coeffi- 
cient; 8 bits, biased exponent; 23 bits, normalized coefficient. 
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/l5 14 


Word 1 


7 6 




Word 2 


A 




1 



\ A / 



E^onent 

V 

Coefficient 



8 Bits 

23 Bits 


Sign of Coefficient 
1 Bit 


A number, for example 25. , would be packed as follows: 

1. convert decimal number to hexadecimal 

25*10 = 16 

2. convert hexadecimal number to binary 


19. le = 0001 1001.2 

3. normalize the binary number (move the binary point to the left of the first one bit) 


0001 1001. 2 = . IIOOI2 X 2' 
coefficient 


^^xponent 
(power of 2) 


4. bias the exponent. In the 1700, all exponents (positive or negative) are biased by 
8O16 (80 is added to the exponent) 

2^ = 5 + 80 = 85i6 

5. pack the number in the two words: 


10000101 


" ex]^ 




110 0100! 0000000000000000 


onent 

85 


sign of coefficient 


V 

Coefficient 
Left Justified 


= 42E40000ie 

A negative number would be packed as though it was positive, then both words 
would be complemented. 

-1916 = 


1 


01111010 


0011011 i 1111111111111111 


= BD1BFFFF10 

To unpack numbers (i. e. , from a HEX dump) the reverse procedure is followed. 
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CHAPTER III 

ASSEMBLY SOURCE FORMAT 






Figure 9. Floating Point Example 


2. 5 


EXAMPLE: PACK 375 

375^0 = 16/375 

Z23r7 ' 

/Lr 7 

177^6 = 0001_0in0in^2 = ^ ^ 

. 1011 1011 1000 X 2® 





IQ P 0 1Q.0 ll 10.^ J LQIlI ip P P PQPP_o PP/^PP.^ 



9 

+ 80__ 
89i6 

EXPONENT: lOOOIOOIg 

-375^0 WOULD BE STORED AS 


FFF F FFFF 
-44 D D COOO 



1 IPlli 0 ij qjoioo^qj o]bo 11 u^u ij j[ij i 
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2.6 EXERCISES ^ 

1. Group these 16 bit 1700 binary numbers into hexadecimal, convert the answers to 
decimal, then add the three together. 

a. 0010 1101 1010 1110 

b. 1000 1111 1100 0111 

c. nil nil 1100 0000 

2. Convert these decimal numbers to HEX, and represent each in binary as they would 
appear as a 16-bit 1700 word. 

a. 4095 

b. -17 

c. 255 

3. How would a signed number, either positive or negative, that occupied only an 8-bit 
field be expanded to occupy a 16-bit field? 
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3. 1 PROGRAM FLOW 

Two phases are involved in processing the assembly language program. The first phase 
involves reading of the source program (the program prepared by the programmer) into 
the computer under control of the assembler program. The assembler program reads 
and decodes the instructions outputting a listing with the object program. The object 
program, which can be output on either paper tape, mag tape, or disk is in a formatted 
form suitable for loading back into the computer under control of the relocating linking 
loader program. This re-entry of the object program into the computer through the loader 
is Phase Two. After loading, relocating and linking this program appropriately to other 
programs, the program can now be executed. Two large standard software packages, 
then, are involved in the assembly process; the assembler itself and the relocating linking 
loader. Figure 10 illustrates this diagrammatically. 


Phase 1 - Assembly of Source Program 


Source Program 



or 


TA/ 

Paper Tape 


1700 Computer 


Assembler 

Program 


Object Program 


Paper Tape 




Listing on typewriter 
or printer 


Phase 2 - Loading and Running of Object Program 


Object Program 

T/V- 




1700 Computer 


Relocating 
Linking Loader 


Results 


Figure 10. Processing the Assembly Language Program 
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3.2 1700 ASSEMBLY LANGUAGE SOURCE FORMAT 

Regardless of the standard assembler being used (utility assembler or macro assembler) 
the source format is prepared the same. This source format consists of four fields, the 
location field, the opcode field, the address field and the comment field as illustrated 
below: 



I Location | Opcode | Address | Comments | 

The total width of all four fields combined is 72 columns. Each field, however, can be of 
any length and the statements are said to be free-field. To signal the end of these fields, 
either a blank or a tab is used. The blank is technically used as the field terminator for 
card input source with consecutive blanks ignored and the first non-blank character 
signifying the beginning of the next field. For paper tape input source the tabular key 
depression is normally the field terminator since the source can be typed using tab fields 
to arrange the source type in an orderly fashion. Blanks, however, can be used for paper 
tape input source as field terminators also. Consecutive tabs will indicate the absence of 
a field. The carriage return key depression will signify the end of a statement for paper 
tape input source. The end of the card itself for card input source is the statement ter- 
minator. 


3. 2. 1 Location Field 

The location field is used for placing symbols which will define positions in the 
program. These symbols have a maximum length of six characters (more than 
six will not be processed by the assembler) and the first character must be alpha- 
betic. 

Example: 

Location Opcode Address Comments 

A123 ►Legal 

1A23 ► Illegal - must begin with 

alphabetic 

TAGTOMB ► Legal - only TAGTOM is 

processed. 


The same symbol cannot be used twice in the same program, as this would con- 
stitute a doubly defined symbol, an error condition. Upon finding a symbol in the 
location field, the assembler places this symbol with its location in its internal 
symbol dictionary. Further references to this symbol then will yield its location. 


An asterisk in the first column of the location field indicates that all subsequent 
information in that statement is to be treated as a remark. 
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Example: 

Location Opcode Address Comments 

* THESE LINES WILL BE PROCESSED AS A REMARK AND 

* APPEAR ONLY ON THE LISTING. THEY DO NOT GENERATE 

* ANY MACHINE CODE. 

START 

Symbols appearing in the location field corresponding to certain pseudo instruc- 
tions are meaningless. These will be discussed under the section dealing with the 
pseudo instructions. A numeric entry into the location field is allowed for one 
pseudo instruction only, the NAM pseudo instruction. 

3. 2. 2 Opcode Field 

hi this field, machine instruction mnemonics or pseudo instructions or macro 
names (if the macro assembler is used) are placed. The machine mnemonics will 
be decoded by the assembler with the appropriate machine codes generated. The 
pseudo instruction will produce action by the assembler and may not, for some 
pseudo instructions, generate any specific machine instructions. Macro names 
will be discussed in Chapter VII. 


Example: 


Location 

Opcode 

Address 

Comments 


NAM 

\ 

1 

NAM is a pseudo- 


1 

\ 

J 

1 

instruction 

START 

1 

T.DA 

1 

j 

LDA is a machine 

1 

1 

J 

1 

1 

1 

mnemonic 


3.-2. 3 Address Field 

The operands used in the address field are: 

Symbolic 

Numeric 

Asterisk 

Special Characters (A, Q, M, 0, 1, B) 

Combination of above special characters joined by arithmetic 
operators (address expression) 

Null (absence of operand) 

Symbols used in the address field either alone or in an expression, must be legally 
defined. Besides appearing in the location field, symbols can be defined as being 
names in the address field of certain pseudo instructions. 
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3.2.3 


Numeric operands in the address field can be either decimal or hexadecimal. To ( 
distinguish between the two, a $ sign would precede the hexadecimal number (1234 ^ 

is a decimal, $1234 would be hexadecimal). The range of decimal numbers must 
be + 32,767. The range for hexadecimal numbers isi:7FFF. Expressions are 
formed by the combination of either symbolic or numeric operands with addition, 
subtraction, multiplication or division operators (+, -, *, /). Nesting is not 
allowed. The expression is scanned left to right with divisions and multiplications 
done first and a second scan left to right for addition or subtraction. An expres- 
sion evaluated as a constant in the address field may be used only with the =X 


form of constant, not =N. 



Example: 



Location Opcode 

1 1 

Address 

Comments 

1 1 

TAGl I 

1 

1 


1 1 
TAG2 LDA 

TAGl+6*$lC/4 



If TAGl is at location 103^0, the expression is evaluated: 

1st) 6 X 28 = 168 
2nd) 168 I 4 = 42 = $2A 

3rd) 0103 + 2A = 012D, then the contents of core location 0120^0 is loaded into 
the A register at run time. 

The asterisk can be used in the address field to also specify the current location 
of the program counter when the instruction is assembled. If the instruction is 
two words long, the asterisk specifies the first word of the instruction. Even 
though the asterisk is also used in the address field as a multiplication sign, the 
logical use of the asterisk for both processes will not conflict. 


Example: 




Location 

1 

Opcode 

Address 

Comments 

TAG 

1 

1 

1 

1 

LpA 

1 

1 

1 

1 

*-2 

1 

1 

1 

Will load A with contents 
of the core location 2 be- 
fore TAG. 

1 

TAGl 

LDA 


The first * refers to the 
location of TAGl, the 
second * is for multipli- 
cation. 


The special symbols Q, I and B are used with the storage reference instructions 
to refer to index registers. Q refers to Q register index modification, I refers 
to the contents of location FF to be used as an index register, and B would specify 
both the Q register and location FF to be added to the base address to form the 
effective address. 


I 
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Example: 


Location 

Opcode 

Address 

Comments 

1 

1 

1 

1 

1 

LDA 

1 

1 

1 

1 

TAG, I 
1 
1 
1 

The contents of core lo- 
c at ion FF are added to 
TAG to produce the ef- 

1 

1 

1 

1 

1 

1 

fective address. 

1 

1 

LDA 

TAG,Q 

Same as above, but Q 

1 

1 

1 

1 

1 

1 

register is used. 

1 

1 

1 

LDA 

1 

1 

TAG,B 

1 

1 

Both Q and I are added. 


The address field for any of the interregister instructions requires either A, Q 
or M registers as a destination. 


Example: 




Location 

Opcode 

Address 

Comments 

1 

1 

1 

AAQ 

1 

1 

1 

A, Q 
1 
1 

Add A to Q and put re- 
sults in A and Q 

1 

1 

1 

TRA 

1 

1 

1 

A, Q, M 

1 

1 

Transfer A to A, Q and 
M registers 


For the interregister instructions, A, Qand M, refer to the registers A, Q and M. 



3.2.4 Comment Field 

This field is used for remarks that are printed as part of the list output. Entries 
in this field do not produce any machine code. 

If it is desired to put a comment on an instruction which does not have an address 
field (i. e. , SLS) it is advisable to put a 0 in the address field, before the comment 
begins, to eliminate an assembly error message. 

i. e. , SLS COMMENT incorrect 

SLS 0 COMMENT correct 

3. 3 ASSEMBLY LISTING 

The assembly list consists of 18 columns of descriptive information related to the source 
statement, followed by a maximum of 80 columns listing the source statement. 
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Column 

Contents 

1-4 

line number; truncated to 4 decimal 
digits 

5 

space 

6 

relocation designator for location 


P program relocation 
D data relocation 

7-10 

location in hexadecimal 

11 

space 

12-15 

machine word in hexadecimal 

16-17 

relocation designator for word 


P 

program relocation 

-P 

negative program relocation 

C 

common relocation 

-C 

negative common relocation 

D 

data relocation 

-D 

negative data relocation 

X 

external 

blank 

absolute 


18 space 

19-98 input source statement 


SYMBOL TABLE A table containing the location symbols, locations, and relocation 
values is printed at the end of pass 3 if the L option is selected. For- 
mat of the symbol table: 


Column 


Contents 


1-6 

9-12 

13 


symbol name 
location 

relocation of location 


15-20 

23-26 

27 


symbol name 
location 

relocation of location 


29-34 

37-40 

41 


symbol name 
location 

relocation of location 


The columns not specified above contain spaces. 
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Figure 11. Sample Assembly Listing 


Line Number 

Location (relative to beginning of program) 

Contents of Location (hexadecimal code 

of instruction) 


0001 





NAM 

SOURCE 

0002 





ENT 

START 

0003 

POOOO 

0000 


START 

0 

0 

0004 

POOO 1 

C400 



LDA + 

X 


P0002 

0006 

P 




0005 

P0003 

60FF 



STA- 

I 

0006 

P0004 

1400 



JMP + 

(START ) 


P0005 

8000 

P 




0007 

P0006 

0010 


X 

NUM 

$ 10 

0008 





END 

START 


J 


OOFF START 


V 

t 

Input Source Statements 

OOOOP X 0006P 


-Number of errors 
would appear here 


Symbol Table 


Appendix D contains error messages. 
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CHAPTER IV 


BASIC 1700 INSTRUCTION FAMILIARIZATION 



CHAPTER IV - Basic 1700 Instruction Familiarization 



TOPIC 

PAGE 

4.1 

LDA, STA, ADD Assuming Data Available 

4-1 

4.2 

LDA, STA, ADD Using Preset Data 

4-1 

4.3 

LDA, STA, ADD Using Preset Data to 
Illustrate Looping 

4-2 

4.4 

STQ and MUI Instructions 

4-2 

4.5 

LDQ and DVI Instructions 

4-3 

4.6 

JMP and RTJ to Illustrate a Subroutine 

4-3 


V- ,...i 



4.1 



4. 1 LDA, STA, ADD ASSUMING DATA AVAILABLE 


The Load A (LDA) instruction replaces the contents of the A Register with the contents of 
the referenced memory location. The contents of the memory location is not changed. 

The Store A (STA) instruction replaces the contents of a referenced memory location with 
the contents of the A Register. The contents of the A Register is not changed. 

The Add to A (ADD) instruction forms a 16-bit sum of the contents of the A Register and 
the contents of the referenced memory location and places this sum in the A Register. 
The contents of the memory location is not changed. 


Problem: Replace the contents of location SAVE with the sum of the contents 
of locations SAVE and DATA, assuming that both locations con- 
tain legal data. 

Location Opcode Address 


LDA 

DATA 

ADD 

SAVE 

STA 

SAVE 


4.2 LDA, STA, ADD USING PRESET DATA 


The NUM instruction creates a table of constants listed in the address field behind the 
instruction. If a Label is given, it is assigned to the first value. 


The BSS pseudo instruction reserves a segment of core to be used for any purpose. The 
data contained is unknown at load time. 

The BZS pseudo instruction reserves a segment of core to be used for any purpose and 
fills this area of core with all zeroes. 


Problem: Add zero to the contents of location TAG and store the result in 
location TAG2. Locations TAG and TAG2 should then be equal. 

Location Opcode Address 


TAG 

NUM 

$423 


BZS 

TAGl(l) 


BSS 

TAG2(1) 


BEGIN 

LDA 

TAG 


ADD 

TAGl 


STA 

TAG2 
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4.3 


4.3 LDA, STA, ADD USING PRESET DATA TO ILLUSTRATE LOOPING 

The Skip if A is Zero (SAZ) instruction checks the contents of the A register. If A is all 
zeros, the program skips to a prestated location up to 16 locations forward, (never back- 
ward). If not, program control goes to P + 1 (the next location). 

The Skip if A is Positive (SAP) instruction checks the uppermost bit of the A register. If 
this bit is "0" (positive), program execution will skip to the specified location up to 16 
locations forward, (never backward). If not, the program will continue at P + 1. 

The Skip if A is Minus (SAM) operates identically to the SAP instruction except that the 
uppermost bit of the A Register is checked for a ”1", indicating a negative quantity. 

Problem: Add 21^0 to each of the quantities in array TAGl and then store 
these new numbers at array TAG2. 

Index Register I will be used for controlling the loop. It starts at 4 and progresses 
through 3, 2, 1, 0, then the loop ends when it turns negative. 


Solution: 




Location 

Opcode 

Address 

Comments 

TAGl 

NUM 

$4152, $0431, $0210 



NUM 

$12F3,$F201 



BSS 

TAG2(5) 


TAG3 

NUM 

$21 


ONE 

NUM 

$0001 


SAVE 

NUM 

$0004 


BEGIN 

LDA 

SAVE 



STA 

$FF 

4-^FF for loop control 


LDA 

TAG3 

1st no. ► A 

LOOP 

ADD 

TAGl, I 

(A)+(TAG1 +(FF)) ► 


STA 

TAG2, 1 

(A) ► TAG2+(FF) 


LDA 

$FF 



SUB 

ONE 

Subtracts 1 from A 


STA 

$FF 



SAZ 

DONE-*-l 

Skip to DONE if (A) = 0 


JMP 

LOOP 


DONE 

SLS 

0 

Stop Instruction 


END 




4.4 STQ AND MUI INSTRUCTIONS 

The Store Q (STQ) instruction replaces the contents of the referenced memory location 
with the contents of the Q Register. The contents of Q are unchanged. 
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4.4 


The Multiply (MUI) instruction forms a 32-bit product of the contents of A (multiplier) 
and the contents of the referenced memory location (multiplicand) and places the product 
in the QA Registers. The contents of the memory location is not changed. 


Problem: Multiply the contents of MEM by the quantity 20^0 which is currently 
in A. Store the results of A in memory location A and the results 
of Q at memory location Q. 


Location 


Opcode 

Address 

Comments 

MUI 

MEM 


STA 

A 


STQ 

Q 



4. 5 LDQ AND DVI INSTRUCTIONS 

The Load Q (LDQ) instruction places the contents of the referenced memory location into 
the Q register. Contents of memory are imchanged. 

The Divide Integer (DVI) instruction divides the 32-bit QA Register by the contents of the 
referenced memory location. The contents of memory are not changed. Q will contain 
the remainder and A the quotient. 


Problem: 

Divide 4528- ^ by the contents of location SAVE 

Solution: 




Location 

Opcode 

Address 


SAVE 

NUM 

$0025 

Divisor 

TAGl 

NUM 

$4528 

Dividend 

TAG2 

NUM 

$0000 



LDQ 

TAG2 

Clear Q 


LDA 

TAGl 

Get dividend 


DVI 

SAVE 

Answer is in A 


4. 6 JMP AND RTJ TO ILLUSTRATE A SUBROUTINE 

The Jump (JMP) instruction causes a program sequence to terminate and initiates a new 
sequence at a specified location. 

The Return Jump (RTJ) instruction is a jump enabling the program to begin execution in 
a new location and, by storing a return address, return to the next instruction in the 
program sequence. 

Problem: During the main program sequence, skip to a routine to clear a 
storage area, and return to the location which the program left. 


4-3 



4.6 


Location 

Opcode 

Address 

Comments 


LDA 

NAME 



STQ 

SAVE 



RTJ 

1 

1 

CLEAR 

Leaves P+2 in CLEAR. 
Program Control given 
to LDA TAGY. 


1 

SLS 



CLEAR 

0 

0 

Return address placed 


LDA 

TAGY 

here. 


STA 

1 

1 

TAG2 

Clear location(s) 


1 

JMP 

1 

1 

(CLEAR) 

Will return control to the 
SLS instruction. 

TAGY 

1 

NUM 

0 


TAG2 

BSS 

TAG2(1) 
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5.1 


INTRODUCTION 

There are five classes of instructions in the 1700. They are: 

Shift Class Instructions 

Skip Class Instructions 

Storage Reference Class 

Register Reference Class Instructions 

hiterregister Class Instruction 

Only the storage reference class uses core for operands. Instructions in all classes other 
than storage reference class are one word instructions and take 1. 1 microseconds to execute 
with the exception of the shift class instructions whose execution time depends on the number 
of bits shifted, and INP and OUT instructions. Refer to Appendix B for instruction execution 
times, or to section 5. 1. 3. 


5. 1 STORAGE REFERENCE CLASS 


Of the five classes of instructions in the 1700, only this group uses core for operands. 
This means, then, that the instructions in this group are the only ones that are address- 
able. Because of the limitation of 16 bits in an instruction word to implement the ability 
to reach any core location from any other core location, two-word instructions are used. 
One- word instructions are available for addressing either absolute core blocks or within 
a fixed range of corelocations from the instruction. The format for these instructions is: 


first word: 


Address Mode 


15 


12 il 10 ~9 ? 7 


F 

r 

ind 

1 ^ 

i 

A 

Instrifction \ 


^ 1 

L i 


Delta 


Relative 

Address Flag — I 

Indirect Address Flag 
(ind. ) 


Index Register Flag 


Q 


Index Register Flag 


second word: 


M 


A is not zero for one- word instructions. 

A is zero, and M contains the operand (or operand address) for two-word instructions. 

The instructions are defined by the F field and will be discussed later. The rest of the 
format word deals with various ways of addressing the instruction; this will be discussed 
first. 
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5.1 


Figure 12 


Address Modes for Storage Reference Class Instructions 


first word: 


second word: 


Name 


ADDRESS MODE 


12 11 10 9 8 7 0 


F r ind q i 

A 

Instruction i i 

Relative 

Address Flag 1 

Indirect Address Flag^ 
(ind) 


t 

Delta ' 

I Index Register Flag 
Q Index Register Flag 

1 


M 

1 


Assembly Language 

, Designator , 

Opcode Address 

Terminator Field 


Example 

Operand Hex 

Address Code- Instruction Comments 


A 7 ^ 0 for one-word instructions 
A = 0 for two-word instructions 


cooo cooo cooo 

0203 2000 4142 


Constant 


N P+1 

X 

A 

** 

*** 

***=(: 

LDA =N$203 
LDA =XBUF 
LDA =AAB 

Numeric constant $203 ► A 

Address of BUF — ► A 
ASCII codes for AB ►A 

One- Word Absolute 

- 

A 

COFF 

LDA- $FF 

Contents of location $FF ► A 

One- Word Abs. Ind. 

( 

) (A) 

C4FF 

LDA- ($FF) 

Loc $FF contains address of operand; operand 
is loaded into A 

Two- Word Absolute 

+ 

M 

C400 

0106 

LDA+ $106 

Contents of location $106 ►A 

Two-Word Abs. Ind. 

+ ( 

) (M) 

C400 

8106 

LDA+ ($106) 

Loc $106 contains address of operand; operand 
is loaded into A 

One- Word Relative 

* I 

P+ A 

C845* 

LDA* BUF 

Contents of loc BUF — ►A; BUF is within 127io 
Iocs of the LDA instr. 

One- Word Rel. Ind. 

* . ( 

) (P+A) 

CC45 

LDA* (BUFADR) 

Loc BUFADR contains addr of operand; operand 
in BUF — ►A; BUFADR is withi n 127 Iocs of 
LDA instr. 

Two- Word Relative 


P+l+M 

C800 

0044 

LDA BUF 

Contents of loc BUF — ►A; BUF is any distance 
from the LDA instr. 

Two- Word Rel. Ind. 

( 

) (P+l+M) 

CCOO 

0044 

LDA (BUFADR) 

Loc BUFADR contains addr of operand; operand 
►A; BUFADR is any distance from the LDA 


instr. 


*If the buffer is 45 ig locations in the positive direction from this instruction 
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5.1.1 


5. 1. 1 Addressing for Storage Reference Class Instructions 

Figure 12 illustrates the various ways of addressing storage reference class in- 
structions. The combination of the r, ind, and A bits determines the mode of 
addressing used. Because of the limitation of 16 bits in an instruction word, some 
modes of addressing require two words to reach all parts of core. A brief glance 
at this chart shows a direct correspondence between two- word instructions and the 
bit content of A. When A (bits 0-7) in the instruction word is all O’s, two con- 
secutive core words are used as a single instruction. Also, there are only three 
main types of addressing: constant, absolute and relative. Within the absolute 
and relative types are one and two-word varieties and also one and two-word 
indirect types. Listed also in this table are the proper assembly language desig- 
nators necessary to tell the assembler the exact mode of addressing desired. In- 
direct addressing is specified by parentheses enclosing the address field contents. 
This table ignores manipulations with the index register since index register 
modification is common to all modes of addressing. This figure gives only the 
base address for each mode. The base address must be found before index register 
modification occurs even when indirect addressing is specified, hi each of the 
indirect addressing modes notice that the base address is specified as the contents 
(the use of parentheses around the address specifies the contents of) of its corres- 
ponding non- indirect mode. This means that for indirect addressing a further 
search is made into the addressed core location to find the base address. 

5. 1. 1. 1 Constant Mode 

This mode of addressing is used where an operand is known to the programmer, 
that is, he is using a constant. This mode of addressing utilizes two words. 

The first word of the instruction is specifically the instruction itself, the mode of 
addressing for this example is constant, and the unused bits in this word will be 
set to zero. This arrangement is illustrated below: 


15 


► Bit 

0 

F 

0 0 q I 

0000 00 00 

Instruction i 
1 


k 4_ind=0 
Lr=o 

o 

o 

II 

< 

J 


The upper four bits signify the actual instruction. This field is called the F field. 
The next four bits, that, is, bits 8, 9, 10 and 11, are used to signify the mode of 
addressing for the instruction. Also, bits 8 and 9 will signify indexing, where 
bit 8 signifies index register I which is core location FF, and bit 9 will indicate 
indexing with the Q register. For the constant mode of addressing bit 10, which 
is called the indirect bit, is a zero and bit 11, which is called the relative bit, is 
also a zero. For our example here, we will assume no indexing used, therefore 
bits 8 and 9 will be 0. The lower eight bits, that is bits 0-7, are called the A 
field, and for constant mode of addressing all these bits are O's. 
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5. 1.1.1 


The combination of the A field, the indirect bit and the relative bit are indicators 
to the machine of the mode of addressing used. Note for constant mode the field 
is all O’s, the indirect bit is a 0 and the relative bit is a 0, signifying constant 
mode of addressing. 

Numeric constants . This form is for numbers. 

Example: 

LDA =N$407F 

This constant mode instruction written in assembly language will generate two 
machine words of code: 


at P COOO 

P+1 407 F 

The operand itself is placed in the second word, so the base address is P+1, the 
second word of the instruction. 


The =N in the address field signifies to the assembler the constant as numeric (a 
number). The number can be either decimal or hexadecimal (in which case it is 
preceded by the dollar sign). The result of the above example is to load into A 
the number 407 Fi 0 . 

Example: 


LDA =N256 

The decimal number 256 would be converted and the following code generated; 

at P COOO 

P+1 0100 

Illegal example; 

LDA =N$100+$27 

An error message would result because address arithmetic (+) is not allowed with 
the =N form of constant addressing. 

Address constants . This form is for 15-bit addresses and address arithmetic on 
numbers. 


Example; 

LDA =XTAG 

The =X in the address field signifies that TAG is a symbol. The assembler sub- 
stitutes the value in its symbol directory for the symbol and puts this value in 
P+1. If, for example, TAG is a location symbol at address 100 in the program, 
the following code is generated. 
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cooo 

0100 


at P 
P+1 

An expression can also be used: 
LDA 


=XTAG+10 


5. 1.1.1 


This will put the address of TAG+10 in the code: 

at P COOO 

P+1 OlOA 

The =X form of address constants is the correct way to allow numeric address 
arithmetic: 


ADD 


=X$34F2-022+$lA 


will generate code to add to the contents of the A register 34F6-j^0. 

t P CO^ O^ 

P+1 34F6 


Even though the result of the expression in the address field is a constant, the =X 
form must be used rather than =N because an expression is not allowed with =N. 
LDA =X$100+$27 would be legal and would generate: 

at P COOO 

P+1 0127 

In address expressions only a 15-bit constant will be produced so note that 
LDA =X-TAG 

will generate 

at P COOO 

P+1 7EFF (not FEFF) 

also, with numbers: 

LDA =X-11 

will generate 

at P COOO 

P+1 7FF4 

This feature of the assembler can well be utilized in sophisticated coding. 

ASCII constants. This form is for alphabetic and numeric characters. 

Example: 

/ 

LDA =AXY 
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5. 1.1.1 


The =A means that the alphanumerics following (only 2 allowed) are to be converted 
to their ASCII 8~bit code. (See Appendix E. ) The first alphanumeric (X in this 
case) ASCII code is placed in the high order 8 bits of P+1, and the second ASCII 
equivalent is placed in the lower 8 bits. The code will be: 

at P COOO 

P+1 5859 

A blank is a character in the ASCII form: 

LDA =A X 

will generate the code: 

at P COOO 

P+1 2058 

ASCII will be discussed in detail when l/O is discussed. 


Examples; 


COOO 

1000 

LDA 

=N$1000 

Get 1OOO]^0 into A register 

COOO 

00C8 

LDA 

=N200 

Get 200;i^0 register 

COOO 

0500 

LDA 

=XDATA 

Get address of DATA P0500 
into A register 

COOO 

0505 

LDA 

=XDATA+5 

Get address of DATA+5 into A 
register 

COOO 

7EFF 

LDA 

=X-$100 

Get 15-bit negative of IOO 10 
into A register 

COOO 

5820 

LDA 

=AX 

Get ASCII constant X into A 
register 



5. 1. 1. 2 Absolute: One Word 


As was mentioned before, there are both one- word and two-word instructions for 
the Storage Reference Class. Let's examine the absolute mode of addressing in 
its one-word form. The format for this mode of addressing is: 


X5 ^ ^ ^ 0 


F 

0 

0 

Q 

I 

A 

Instruction ^ 

Relative bit = 0 
Indirect bit is 0 

k i 

‘ A is a non- zero 


The F field remains the same as in constant mode, that is, it signifies the type of 
instruction within this class used. The relative bit and the indirect bit are also 
O's for this class. However, A is non- zero (See Figure 12). It may have been 
noticed now that this one- word type instruction has A non- zero where the con- 
stant mode example had A as zero and was a two- word type. The actual value in 
A will be the absolute address. Notice the size of A . It is only eight bits which 
means that the range of numbers in hexadecimal is from 01 to FF. In decimal 
this gives a range from 1 to 255. This is the limitation on this mode of addressing. 
Its advantage is its one- word length. To implement this absolute region from 
corelocation 01 toFF, all operating systems for the 1700 define this area as being 
the Communications Region. In this region are placed all system masks and all 
references to other points in the system allowing quick access through this region 
with this mode of addressing. 

Example: 

START LDA- $21 

, STA- $EC 

The contents of location 21x0 in the absolute communications region is moved to 
core location ECx0* The minus sign as an opcode terminator signals the assem- 
bler to form a one-word instruction with the A field set to the address. The 
example above generates two one- word instructions: 

C021 

60EC 

Example: 

LDA =N0 

STA- $FF 

This example clears index register I. Since I is core location $FF which is in 
the communications region, all references to I will use absolute one- word ad- 
dressing. 




5.1. 1.2 


The base address, for one-word absolute mode of addressing cannot be 0 since a 
delta of 0 results in a two- word instruction at run time. 

Example; 

LDA- $4F-$50+l 

This results in base address of 0 which is an assembly error. The base address 
must be 01 to FF at run time. 


5. 1. 1. 3 Absolute: One Word Indirect 

This mode of addressing is the indirect version of the absolute one-word. Its 
format, then, will be the same as for one-word absolute; however, bit 10 (the 
indirect bit) is set. Its base address, then, is not A but the contents of A and 
further, if the high order bit of the contents of A is a 1 then the indirect search 
will continue. This mode of addressing is extensively used where locations in the 
communications region contain addresses of other programs. The reference to 
these other programs is made by the use of the one-word absolute indirect mode 
of addressing through the communications region. 

Example; Assume location E0 in the communications region always contains the 
address of a desired routine. The routine can then be entered by: 

JMP- ($E6) 


5. 1.1.4 Absolute: Two Word 


Since it is necessary to be able to absolutely address any core location from any 
other core location, it takes a second word for the absolute mode of addressing to 
specify the absolute address. The format for absolute two- word mode of ad- 
dressing is; 


P 

P+1 

r = 0 
ind = 1 
A = 00 



in P+1 


16 


Again, F will specify the particular instruction, A will be 0, the relative bit (bit 
11) is 0, and the indirect bit (bit 10) is set. The second word of the instruction 
will contain the actual absolute address. Since the limit for allowable core in the 
1700 is 32,767, only 15 of the 16 bits in the second word are utilized for this 
absolute address. For absolute two-word bit #15 of the second word will be 0. 
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5. 1.1. 4 





Example: 

COUNT 0 0 

START LDA+ COUNT 

The + opcode terminator signals the assembler that the base address must be 
placed in P+1. The base address, then, is (P+1). Notice (Figure 12) that this is 
really the indirect case for constant mode. 

The address COUNT is placed in the second word. If the assembler’s program 
counter for COUNT is at 0033, then at 0034 the assembler would generate: 

C400 

0033 

START STA+ $7F32-41 

The address is calculated as 7F32-j^0-2920 or 7F09 and this address is placed in 
the second word of the instruction: 

At START location 6400 

7F09 

Example: Add IOOO^^q to the contents of core location 1000. 

LDA+ $1000 

ADD =N1000 

STA+ $1000 

5. 1.1. 5 Absolute: Two Word Indirect 

With indirect addressing the base address does not contain the operand itself, but 
rather this base address contains the address of the operand. Notice from Fig- 
ure 12 that two- word absolute is actually a case of constant mode indirect. Instead 
of base address being P+1 as in constant mode, the search is made into P+1 for 
the base address. The indirect bit which is set for two-word absolute mode is 
actually a case of constant mode indirect. Indirect addressing, however, can be 
multi-level; that is the search may continue from address to address to find the 
final base address. The continuation of this indirect search is accomplished each 
time bit 15, the high order bit, of the base address is a 1 and the indirect bit (bit 
10) is set. Using this high order bit of the address as an indirect flag is possible 
since only the low order 15 bits of this address can contain another address. Since 
the indirect bit is already set for the two-word absolute mode of addressing, the 
use of parentheses in the address field for this mode of addressing will cause bit 
15 of the second word to be set. This forms two-word absolute indirect mode of 
addressing. 

Example: 


TAG 

- 

- 

Assume TAG contains 0400 

START 

LDA+ 

(TAG) 
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5.1. 1.5 


If TAG is at the absolute location 0301, this code is generated: 

302 C400 

303 8301 

The high order bit of 303 is set. The contents of 303 is examined at run time and 
since the high order bit is set, the search for abase address continues. The con- 
tents of 301 is brought out, and if the high order bit is a 1, the search would con- 
tinue; in this case, however, the high order bit is a 0, so 400 is the base address. 
The effect of this instruction, then, is to load A with the contents of 0400. 

Example; Assume the following values in core; 


Core 

Value 

500 

C400 

501 

COlO 

400F 

3407 

4010 

8501 


If the contents of core location 500 were executed as the first word of a two-word 
instruction, the computer would be in an endless loop searching for an address. 
The instruction at core location 500 is; 

LDA+ ($4010) 

Since this is two-word absolute indirect, the search continues to core location 
4010 for an address. Bit 15 is set in core location 4010, so the search continues 
to 501, then back to 4010, etc. This condition is catastrophic, of course, but it 
illustrates the fact that the search for an address will continue until bit 15 is a 0; 
then this cell contains the base address. 

5. 1. 1. 6 Relative: One Word 

There are two types of relocation associated with programs. One is called pro- 
gram relocation which means that the assembler begins the assembly with its 
program counter equal to zero so that this program, when it is loaded into core 
by the relocating linking loader, can be relocated anywhere. This program re- 
location is strictly a function of the assembler and the loader. This ability allows 
the program to be loaded anywhere into the core and run. Once loaded, the ability 
to take the same program and move it from one area of core to another and the 
program still run, is not a function of the loader. This type of relocation is known 
as dynamic relocation or "run anywhere" . In process control programs, generally 
many programs are put on a mass storage device with a common area of core 
allotted for running these programs at any time. To allow proper allocation of 
this core area the programs on the mass storage device should be run anywhere 
so they can fit into space available in the common area rather than in a particular 
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r ■ . 


area of the common core. Achievement of run anywhere programs is the result 
of the use of the relative mode of addressing in the 1700. For the one- word rela- 
tive mode of addressing A will contain a signed increment that when added to P 
will yield the base address. The base address is made relative to P or where the 
program instruction presently is so that if the whole program is moved, the same 
relative distance is maintained between instructions/data and the base address 
found in exactly the same manner, since P is variable. The format for the one- 
word relative commands is: 


F 


1 0 Q I 


A 


Contains signed 8-bit 
increment 


The limitation for this one-word relative mode of addressing is the size of A . 
Since A is 8 bits and signed, the range from P is +7F to 80 (-7F), or ±127 ]^q. 

Example: 


LOOP 


- * a o o a 0 

Tilt, , 


JMP* LOOP 

If the JMP instruction is - 121 locations back or less, the one- word relative form 
can be used (and is preferred). Assume the program counter is at 0100^0 for 
LOOP and at 01432^0 for the JMP instruction, then the JMP instruction decodes at: 

J 18BC Note: A is BC which is -43i0 in 8 bits. 

The * opcode terminator is used to signify to the assembler one-word relative 
mode of addressing. 

Example: Consider the same basic structure but coded absolutely, then rela- 

tively. Assume the distance from LOOP to LAST is less than 1272Q* 

a) LOOP 

LAST JMP+ LOOP 

b) LOOP 

LAST JMP* LOOP 

For a) above, the routine could not be moved to another core location once loaded 
because with two- word absolute used with the JMP instruction, the absolute ad- 
dress placed in the second cell would cause a jump back to the original location 
of LOOP. But in case b), the incremental difference placed in A for JMP* LOOP, 
and since the distance between LOOP and LAST will not change if the whole routine 
is moved, the program will jump to the new location of LOOP, b), then, is "run 
x-'N anywhere" where a) is not. 
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5. 1. 1. 7 Relative: One Word Indirect 

This mode of addressing is an extension of the one-word relative to the indirect 
mode; the relative bit is set, the indirect bit is set, and A is non- zero (see Fig- 
ure 12). With the base address found as in one-word relative (P+A) a further 
search is made in this address location for the base address. The indirect bit is 
set and the search will continue if the high order bit in the contents of P+A con- 
tains a one. 

Example: 

ADDR - - Contains an address- 

Assume 0600. 


JMP* (ADDR) 

For this example ADDR must be within 127 lo of the JMP instruction and ADDR 
contains the address, 0600, to which control will pass. This routine jumps to 
location 600 and continues program execution from there. 

5. 1. 1. 8 Relative: Two Word 

Two-word relative mode of addressing is used when the difference between the 
instruction and the address is greater than the limitations imposed by one-word 
relative, that is greater than +127io* Two words are necessary and in the second 
word of the instruction is placed the difference between that word and the address. 
The base address is then P+l+M where M is the contents of P+1. 

Example: 



Two word relative mode of addressing is used here since the difference between 
the JMP instruction and LOOP is greater than -7F. The above JMP LOOP would 
decode as: 

400- 1800 

401- FCFE 

Notice that the difference between P+1 and LOOP is placed in P+1. 
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5. 1. 1. 9 Relative: Two Word Indirect 

This mode of addressing is the extension of the two-word relative to the indirect 
mode; the relative bit is set, the indirect bit is set and A =00 since this is a two- 
word instruction. With the base address found as in two-word relative, a further 
search is made in this address location for the base address. The base address 
is then (P+l+M). The search will continue if the high order bit of the contents of 
P+l+M contains a one since the indirect bit is set. 

Example: 

ADDR - - Contains an address- 

Assume 0600, 


JMP (ADDR) 

ADDR can be any distance from the JMP instruction and ADDR contains the ad- 
dress, 0600, to which control will pass. 

5. 1. 1. 10 Review of Addressing Modes 

A cross check back through Reference 1, Appendix A, page 3-4 will show that the 
Computer Reference Manual describes the storage reference class as having 7 
modes of addressing. A count from Figure 12 here shows 9 distinct modes of 
addressing. Although a seeming conflict exists, there is really none. From the 
viewpoint of basic machine language, there are only 7 modes since two-word 
absolute indirect to the basic machine is nothing more than an extension of two- 
word absolute in the indirect mode and both relative modes can be grouped to- 
gether as one. When considering the manner in which the programmer must 
specify the different modes to the assembler, there are 9 different combinations 
as described. Some of the terminology also differs between this training manual 
which essentially follows the terminology of the assembler manuals and the ter- 
minology used in the computer reference manual. The basic difference in ter- 
minology is: 

Storage Mode is the same as Two- Word Absolute 
Absolute Mode is the same as One- Word Absolute 
Indirect is the same as One-Word Absolute Indirect 
Relative Mode is the same as One- Word Relative 
16- Bit Relative is the same as Two- Word Relative. 

5. 1. 1. 11 Indexing 

Two index registers are available, the Q register and the I register which is 
actually core location FF. The contents of these registers can be used to modify 
the base address to form an effective address. This indexing, or address modi- 
fication is accomplished simply by adding the contents of the specified index 
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register (either Q or I or both) to the base address. If indirect addressing is V,, 
specified, the search is made to find the final base address before indexing is 
done. This simplified flow chart illustrates this: 



The use of indexing is wide-spread principally for forming repetitive loops for 
the type of work that would otherwise require an inordinate amoimt of repetitive 
programming. 

Example : 

Suppose the problem is to add together a series of numbers located in consecutive / — ■' 

memory locations 1000 thru 1002 and then store the result into a location called 
TEMP. This routine would accomplish the additions: 

TEMP 0 0 Reserve Temporary Lo- 


START 

LDA+ 

$1000 

cation 


ADD+ 

$1001 



ADD+ 

$1002 



STA* 

TEMP 



If the series of numbers to be added was much longer, however, the length of the 
program, due to the number of ADD instructions, would be prohibitive. The same 
problem, with the numbers to be added in core 1000 thru 2000, ignoring overflow, 
and with the instructions covered so far would be solved with an indexed loop: 


TEMP 

0 

0 

Reserve temporary loc. 

START 

LDQ 

=X$2000-$1000 

Difference in Q 


LDA+ 

$1000 


LOOP 

ADD+ 

$1000, Q 



ADQ 

=N-1 

Decrease Q by 1 


SQZ 

DONE-*-l 

Finished? 


JMP* 

LOOP 

No 

DONE 

STA* 

TEMP 

Yes 
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Here, Q is set up as the index register used. The , Q in the address field signifies 
Q register indexing, and the assembler will set bit 9 in this instruction word. Q 
contains initially the difference between the lower and upper core locations of the 
numbers to be added. For each pass through the loop, Q is decreased by 1 allowing 
the next lower core location contents to be added in turn. The sequence of addition 
is: (1000) from the LDA instruction, (2000) from B.A. * of 1000 +Q which is 
initially 1000, (IFFF) from B. A. of 1000 +Q which is now 1 less or OFFF, 

(IFFE) , till (1001). When Q is decreased to 0, the SQZ instruction skips out 

of the loop. 

If Q were not available at this point in the program, I could be used: 


TEMP 

0 

0 

Temporary storage 

START 

LDA 

=X$2000-$1000 



STA- 

$FF 

Index Register I 


LDA+ 

$1000 


LOOP 

ADD+ 

$1000,1 



STA* 

TEMP 



LDA- 

I 

Can use either I or $FF 


ADD 

=N-1 



STA- 

I 



SAZ 

ENDIT-*-! 



LDA* 

TEMP 



JMP* 

LOOP 



ENDIT Result is in TEMP 


The , I in the address field signifies to the assembler that I register indexing is to 
be used and bit 8 in the machine language word is set. 

I cannot be manipulated as easily as Q. TEMP is used to store the partial results 
of the adds when the A register is used to manipulate the contents of the index 
register I. 

The ,B in the address field signifies to the assembler that both Q and I indexing 
are to be used. 

The use of Q as an index register does not increase the execution time, but use 
of I indexing takes 1. 1 microseconds longer. 


*Base address 


r 
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Addressing Problem 

Given are contents of the index registers and some core locations. 
Contents of any locations not shown is zero. What will the A register 
contain after each instruction is executed? 

(I )=0020 ( 1000 ) = 0120 ' 

(Q)=0120 (0240) = 1234 

(1234) = 02EI^ 

(0260) = nil' 

(1254) = 2311 
(1111) = 9000 

(A)= 


a. LDA+ $240 

b. LDA+ ($240) 

c. LDA+($240),I 

d. LDA+ ($1111), B 
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STORAGE reference 





* 



F RIQl delta 



M 



« 

* 





' ( P^ 1 ) «««« 

«««« «»«» 



«■ 

* 












4 







t 

<^MNE«*0P£RATI0N<» 

4> 


<»MODE<^ 

<>BA*, »OP<H>ADR<* 

» 






4 







1 

JMP 

EFAr*P 

0 

= 00 

CONSTANT<> 

P*1 

s 




2 

MUI 

(EFA) X (A) f*QA 

0 

?fc00 

ABSOLUTE 

DELTA 




•» 

3 

DVI 

(QA)/(EFA),»A*ReMr>Q 

4 

eOO 

STORAGE 

M ♦ 





4 

STQ 

(Q) r»EFA 

4 

= 00 

STORAGE indirect 

(M) ♦ 

{ 

) 



5 

HTJ 

P-*-lv^r»EFA,EFA4.1,#P 

4 

#00 

INDIRECT 

(DELTA) - 

( 

) 

ft 


6 

STA 

(A) r*EFA 

8 

= 00 

long RELATIVE 

P* 1 *M 



ft 

« 

7 

SPA 

(A)r»£FAfPARlTYr»A 

8 

#00 

RELATIVE 

p^delta <» 



ft 

fl- 

8 

ADD 

( A) ♦ (EFA) f*A 

C 

=0 0 

LONG relative INDIRECT 

(P>UM) 

( 

) 

ft 


9 

SUB 

(A)-(EFA)r»A 

C 

#00 

RELATIVE indirect 

(P^DELTa)<> 

( 

) 

ft 

« 

A 

AND 

(A) A(EFA)f*A 

4^ 

«EFA* 




ft 


B 

EOP 

( A)-y-(EFA) f*A 

♦ 0 

8a 




ft 

«> 

C 

lda 

(EFA)f»A 

♦ 1 

BA^(I) 




ft 

•» 

D 

RAO 

(EFA) ♦If^EFA 

+ 2 

BA^ (Q) 




ft 

« 

E 

LDQ 

{EFA)f*Q 

♦ 3 

0A^(Q)4.(I) 




ft 


F 

adq 

(EFA) ♦ (Q)r>Q 







ft 
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5. 1. 2 Instructions in the Storage Reference Class 

The instructions for the storage reference class are: 
F F 


1 

JMP 

Jump 

9 

SUB 

Subtract from A 

2 

MUI 

Multiply 

A 

AND 

AND with A 

3 

DVI 

Divide Integer 

B 

EOR 

Exclusive OR 

4 

STQ 

Store Q 



with A 

5 

RTJ 

Return Jump 

C 

LDA 

Load A 

6 

STA 

Store A 

D 

RAO 

Replace Add 1 

7 

SPA 

Store A, Parity 



in Storage 



to A 

E 

LDQ 

Load Q 

8 

ADD 

Add to A 

F 

ADQ 

Add to Q 


Any of the nine addressing modes, plus indexing, can be used on all of these in- 
structions. 

5.1.2. 1 LDA, LDQ, STA, STQ, AND SPA Instructions 

These instructions are the basic load and store instructions. For the load instruc- 
tions, either LDA or LDQ, the contents of the effective address specified is loaded 
into the registers, either A or Q, as per the specific instruction and the contents 
of the storage location are not altered. The STA and STQ registers store the 
contents of the register into the effective address, replacing what was in this core 
address with the information that was in the register. For the store instructions 
STA and STQ, the original contents of the A or Q registers are not changed. The 
SPA instruction is the same as the STA instruction with the exception that after 
the information from A is stored into the core address specified, A is cleared and 
the parity of the original contents of A is returned to bit 0 of A. This parity bit 
is the value that would be necessary to make the total number of bits of the original 
contents of A plus this bit, odd. This parity bit is not necessarily the same as 
the parity bit that will appear in core for this data word since core might contain 
a program protect bit. In fact, this bit is the exclusive OR of the core parity bit 
and program protect bit. 

Any method of addressing may be used with these instructions. 

Example: 

Location Opcode Address Comments 

LDA TAG 

Contents of A is replaced by the contents of core location labeled TAG. The con- 
tents of TAG is not changed. 
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Location Opcode Address Comments 

SPA TAGl 

The contents of A (assume F2F7) is stored into the core location labeled TAGl. 
Then A is cleared and the parity of the original contents of A is returned to A, bit 
position 0. The parity returned is 1. 

5. 1. 2. 2 ADD, ADQ, SUB, MUl and DVI Instructions 

These instructions are the primary arithmetic instructions for the 1700. Data 
from core can be added to the A register with the ADD instruction, or to the Q 
register with the ADQ instruction. Data from core can be subtracted from the 
A register with the SUB instruction. Notice there is no instruction for direct sub- 
traction from Q. These arithmetic operations can cause overflow (refer to 
Chapter II, Section 4) . 

Example: 

Location Opcode Address Comment 

LDQ TAG 

ADQ =N-6 

Using Constant mode of addressing for the ADQ produced an effective subtraction 
from Q. Q is loaded with the contents of core location TAG and the number -6 is 
added to Q. 

The MUI instruction will multiply an operand in core by the contents of the A reg- 
ister. Both of these operands are 16 bits long, producing a double length, 32 bit 
product in the Q and A registers. The Q register contains the most significant 
portion of the product and the sign of the product and the A register contains the 
least significant portion of the product. The MUI instruction cannot cause over- 
flow. The MUI instruction destroys the original contents of Q. 


Example: 

Location 

Opcode 

Address 

Comment 


LDA 

=N$FF31 

-$CE to A register 


MUI 

=N$31 

Multiply by 31 


Result is (Q register)=FFFF 
(A register)=D891 

The result in the double length register then is -276E20. 

Negative zero can be produced by the MUI instruction; 

(+0) X (-N) = (-0) 

(-N) X (+0) = (-0) 

(-0) X (+N) = (-0) 

(+N) X (-0) = (-0) 
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Division of integers is accomplished with the DVI instruction. It divides the 
double length QA register by the contents of a core location. The Q register must 
contain the most significant portion and the sign of the dividend and A must contain 
the least significant portion of the dividend. The signed quotient will be placed in 
the A register and the signed remainder will be placed in the Q register after 
division occurs. The DVI instruction can cause overflow, if the quotient is larger 
than 7FFF in absolute value. 


Example: 


Location 

Opcode 

Address 

Comment 


LDQ 

=N$FFFF 

=N in address field indi- 


LDA 

=N$FFF0 

cates CONSTANT MODE 


DVI 

=N$FFFA 

OF ADDRESSING used. 
The number following =N 
is the operand. 


This example divides -15 by -5. Notice that Q had to be set to extend the sign to 
32 bits. Result is 0003 in A and 0000 in Q. 


5. 1. 2. 3 AND and EOR Instructions 

These instructions perform logical manipulation of data from the specified core 
location with the contents of the A register. The AND instruction performs a 
logical product operation; its bit by bit truth table is : 


A 

1 

1 

0 

0 


B 

1 

0 

1 

0 


Example: 


Operand 1 — 
Operand 2 — 
Logical Product 


AAB 

1 

0 

0 

0 


15 Bit 0 

nil 0010 1001 0111 
0011 nil 1100 0000 
0011 0010 1000 0000 


The AND instruction is used to extract a certain field of bits, hi the exam pie 
above, a field from bit 6 through 13 is extracted from operand 1. Operand 2 con- 
tains ones in these bit positions and O’s in the remaining bit positions to block out 
the unwanted bits. Operand 2 is referred to as a mask. 
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Example: 

Examine bits 4 thru 7 of core location TAG for all zeroes. 

Location 

Opcode 

Address 

Comment 


LDA 

TAG 

Load (TAG) in A register 


AND 

=N$00F0 

AND with A Mask 


SAZ 

YES-*-l 

Test for zeroes 


JMP 

NO 


YES 

— 

— — 


The EOR logical instruction performs an exclusive 

OR bit by bit. The logical 

rules for an exclusive OR are; 




A B 

AA^B 



1 1 

0 



1 0 

1 



0 1 

1 



0 0 

0 


A 0 is produced as a result of a match between the two bits and a 1 is produced as 

a result of a mismatch. This instruction is frequently used to test for a particular 

bit pattern. 




Example: 

Test for 10110 in bit positions 3 thru 7 of 

contents of core location 


DATA. 



Location 

Opcode 

Address 

Comments 


LDA 

DATA 



AND 

=N$00F8 

Mask out all except 3-7. 


EOR 

=N$00B0 

Test for bits 10110 


SAZ 

YES-*-l 



YES 

If the exact bit pattern 10110 was present in bit positions 3 through 7, all the bits 
in both operands would match, and a positive zero will be in the A register and the 
program will skip to YES. 

An instruction that performs an inclusive OR is not specifically available in the 
storage reference class. The truth table for the inclusive OR is: 


A AVB 

1 1 1 

10 1 

0 1 1 

0 0 0 


A 1 is produced if a 1 appears in either or both operands. Notice that the inclu- 
sive OR logical function can be obtained by the combination of the logical product 
and exclusive OR functions. 
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Example: Form the inclusive OR bit-by-bit of the contents of core location AA 

and BB. 


Location 

Opcode 

Address 

Comment 

TEMP 

0 

0 



LDA 

AA 



AND 

BB 

Logical Product AA & BB 

STA 

TEMP 

Store Temporarily 

LDA 

AA 

Exclusive OR AA & BB 

EOR 

BB 


ADD 

TEMP 

Combine them. Inclusive 
OR is now in A. 


5. 1. 2. 4 JMP and RTJ Instructions 

These instructions alter the path of program flow. JMP is an unconditional pro- 
gram branch to the effective address. The RTJ, besides branching control to 
another core location, also provides the link by which control can be returned to 
the instruction following the RTJ instruction. This allows program flow from a 
main program to a closed subroutine and back again to the main program. This 
is illustrated below: 
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The subroutine is structured with its first location left open to allow the address 
(P+1 or P+2) to be placed by the RTJ instruction. Program control is then given 
to the second cell of the subroutine. By using a jump indirect through the first cell 
as the last instruction in the subroutine, program control will be given to the next 
executable instruction following the RTJ in the main program. This flow is in- 
dependent of the location of the RTJ instruction. 


Example: 




Location 

Opcode 

Address 

Comment 

LOOP 

LDA 

TEN 




JMP 

LOOP 

Simply jumps back to lo- 
cation LOOP 

BACK 

RTJ 

BACKl 

Sets BACK+2 into BACKl 
since mode of addressing 
is 2 word. 

BACKl 

0 

0 

Address BACK+2 is placed 


_ 


here. 


JMP 

(BACKl) 

Will jump not to location 
BACKl, but to location 
whose address is in BACKl 
which is BACK+2. 


To specify indirect mode of addressing the address is placed in parentheses as in 
the above example. This means that the specified address (in this case, BACKl) 
itself contains the address that is desired. More will be said on addressing later. 

5. 1. 2. 5 RAO Instructions 

This RAO instruction is used to increase the contents of the effective address by 
1. This instruction is very useful as a counter where a memory location is ini- 
tialized or preset and the RAO instruction increases the count in this memory cell 
each time a desired condition occurs (number of times through a loop, etc.). 



Example: 




Location 

Opcode 

Address 

Comment 

COUNT 

0 

0 


LOOP 

LDA 

TEST, Q 



SAZ 

2 

Skips to RAO COUNT if A 
is zero 

JMP 

LOOP 


RAO 

COUNT 


JMP 

LOOP 



In this example the contents of core location COUNT is increased by 1 each time 
the A register is found to be zero. This RAO (Replace and Add One) instruction 
can only add one to the contents of the designated corelocation and does not change 
the contents of any of the registers. This instruction can cause overflow and, as 
such, is very useful for loop control. 

Example: Loop through a given portion of a program 12 times then jump to core 

location NEXT. It is necessary to preset a COUNT cell such that in- 
creasing it by 1 will not cause overflow until it has been increased 12 
times. The largest positive number minus 11 then is preset into 
COUNT. 


Location 

Opcode 

Address 

Comment 


SOV 

0 

Turn off overflow if set 


LDA 

=X$7FFF-11 



STA 

COUNT 


LOOP 

— 




RAO 

COUNT 



SOV 

NEXT-*-l 



JMP 

LOOP 


COUNT 

0 

0 


NEXT 

- 




Overflow will occur the 12th time the RAO instruction is performed. 
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5. 1. 3 Execution Times 


EXECUTION TIME 



INSTRUCTION 

(microseconds) 

LDA 

Load A 

2.2 

STA 

Store A 

2.2 

LDQ 

Load Q 

2.2 

STQ 

Store Q 

2.2 

ADD 

Add A 

2.2 

SUB 

Subtract 

2.2 

ADQ 

Add Q 

2.2 

AND 

AND with A 

2.2 

EOR 

Exclusive OR with A 

2.2 

RAO 

Replace Add One in Storage 

3.3 

MUI 

Multiply Integer 

7.0 

JMP 

Jump 

1.1 

RTJ 

Return Jump 

2.2 

DVI 

Divide Integer 

9.0 

SPA 

Store A, Parity to A 

2.2 


Timings are for one- word instructions. An additional cycle must be added for a 
two-word instruction. 

Note the speed of the integer multiply and divide instructions. These are con- 
sidered very fast for the computer hardware. 


*Add 1. 1 microsecond if Storage Index Register is used. 

Add 1. 1 microsecond for each level of Indirect Addressing. 
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SKIPS 


U1 

I-* 

CO 


* 

* F=0 Fl=l 


F2 SKIP COUNT 


* 



:i< * * * 

**** **** **** 


* 

[*i^r rr (*“(*“ rrr(*“f*“rrrr*T rri*“rrrr 



* 


ARITHMETIC TESTS 



MACHINE STATE TESTS 

* 

t 


*TEST* 

1 


*TEST* 

* 

0 

SAZ 

(A)=ZERO 

8 

SWS 

SKIP SWITCH ON 

* 

1 

SAN 

(A)t^ZERO 

9 

SWN 

SKIP SWITCH OFF 

* 

2 

SAP 

(A)=POSITIVE 

A 

SOV 

OVERFLOW 

* 

3 

SAM 

(A)=NEGATIVE 

B 

SNO 

NOT OVERFLOW 

* 

4 

SQZ 

(Q)=ZERO 

C 

SPE 

PARITY ERROR 

* 

5 

SQN 

(Q)^ZERO 

D 

SNP 

NOT PARITY ERROR 

* 

6 

SQP 

(Q)=POSITIVE 

E 

SPF 

PROTECT FAULT 

* 

7 

SQM 

(Q)=NEGATIVE 

F 

SNF 

NOT PROTECT FAULT 


* 


* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 



5.2 


5.2 SKIP CLASS INSTRUCTIONS 

These instructions are used to make conditional tests and skip forward depending on 
whether the instruction meets the actual condition being tested. The format for these in- 
structions appears below: 


15 12 11 8 7 6 5 4 3 0 


0 0 0 0 

0 0 0 1 







V 

( 


F Instruction Sub- Instruction Skip Count 

FI F2 


Notice the skip count is only four bits which allows a skip count of only 15. The skip 
count is not signed so the instructions will only allow a skip in the forward direction. 

If the skip condition is met, program control proceeds to P + 1 + skip count. If the skip 
condition is not met, program control continues from P+1. 

5. 2. 1 A and Q Skip Tests 

The following types of conditional tests are available on the A and Q register: 


F2' 


0 

0000 

SAZ 

A=+0 

1 

0001 

SAN 

A?^+0 

2 

0010 

SAP 

A= + 

3 

0011 

SAM 

A= - 

4 

0100 

SQZ 

Q=+0 

5 

0101 

SQN 

Q?^+0 

6 

0110 

SQP 

Q= + 

7 

0111 

SQM 

Q=- 

Example: 

Location 

Opcode 

Address 

Comments 

START 

LDA 

ARS 

=N$0080 

4 

Loads 0080 into A 


SAZ 

1 

1 is the Skip Count 


ARS 

4 

will not skip to TAG 

TAG 

SAZ 

TAGl-*-l 

will skip to TAGl 


TAGl 

The TAGl-*-l address is a form peculiar only to the utility assembler. With this 
form the assembler is being directed to form a skip count to TAGl, which has 
some program counter value. This counter value, minus the current location of 
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*^the SAZ instructions (which is some program counter valueless thanTAGl), minus 
one more, forms the skip count. The -1 is used to compensate for the +1 in the V 
skip formula P+l+skip count. When using the macro assembler, the address need 
only be TAGl as the macro assembler will automatically calculate the skip count. 

For all cases the distance skipped (to TAGl in this example) must be no greater 
than 16 locations forward from the location of the skip command. The macro 
assembler will also accept the -*-l form. 

5.2.2 Skip Switch Tests 

The SWS and SWN instructions test the condition of the skip switch located on the 
programmer’s panel. This switch can be used to alter program flow from the 
panel. 

Example: 

Location Opcode Address Comments 

START 


TAG SWS GO-*-l 


GO 

TAGl SWN G01-*-l 


GOl 

The code between TAG and GO wUl be skipped at run time if the skip switch on 
the programmer's panel is set. It would be executed if the switch were not set. 

The code between TAGl and GOl will be skipped if the skip switch on the pro- 
grammer's panel is not set. It will not be skipped if the switch is set. 

5.2.3 Overflow Skip Tests 

The SOV (F2=A) and SNO (F2=B) instructions test the state of the overflow indi- 
cator. Refer to Chapter II, Section 4, fora discussion of those arithmetic 
operations causing overflow. The overflow indicator is cleared upon execution 
of these instructions. 
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5.2.3 


Example: 

Location 

START 


CORK 

TAG 


ERROR 


OPl 
OP2 
OPS 
OK 

In the above example, two numbers are added and if no overflow occurred, the 
instructions between CORR and TAG will be skipped and a third number will be 
added. The overflow indicator is again checked and if overflow had occurred, 
the routine would skip to ERROR. The overflow indicator once set, remains set 
until tested with either an SOV or SNO instruction. 

5. 2. 4 Parity and Program Protect Indicator Tests 

The SPE (F2=C) and SNP (F2=D) instructions will test for a storage parity error 
and the SPF (F2=E) and SNF (F2=F) instructions will test for program protect 
fault errors. 


Example : 


Location 

Opcode 

Address Comments 

START 

SPE 

PAR-*-l 


SPF 

PROT-*-l 


JMP 

ERROR 

PAR 

JMP 

PARITY 

PROT 

JMP 

PROTEK 

If either a parity error or a program 

protect fault occurs, an interrupt is generated 

on line 0. 

Since both interrupts can 

occur on the same line, the interrupt pro- 


cessor for this line must distinguish between the two. This example illustrates 
how this might be done with program control going to the location named PARITY 


Opcode 

Address 

Comments 

LDA 

OPl 


ADD 

OP2 


SNO 

TAG-*-l 


ADD 

OPS 


SOV 

ERROR- *-l 


JMP 

OK 


- 

- 
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if a parity error is found, and program control jumping to core location named 
PROTEKif the protection fault caused the interrupt. If neither interrupt was found 
by this process, program control would jump to some error routine to service what 
is apparently a ghost interrupt. The parity and protect indicators (both the inter- 
rupt signal and the programmer’s panel fault indicators) will clear when these in- 
structions are executed. 


Problem: The following routine will move how many numbers ? 

locations to what core locations ? 


MOVE 

0 

0 


LDQ 

=N$1000 

LPl 

LDA+ 

$1000, Q 


STA+ 

$3000, Q 


ADQ 

=N-1 


SQM 

1 


JMP* 

LPl 


JMP* 

(MOVE) 

Problem: 

The following routine sums how many numbers ? 


locations? Where does it store the answer? 

SUM 

LDQ 

=X$2000-$1000 


LDA 

=N$ 

LOOP 

ADD+ 

$1000, Q 


ADQ 

=N-1 


SQM 

DONE-*-l 


JMP* 

LOOP 

DONE 

STA+ 

$3000 

Problem: 

The following routine moves how many numbers ? 
locations to where? 

CHNG 

0 

0 


LDA 

=N$1000 


STA* 

ADDRl 


LDA 

=N$4000 


STA* 

ADDR 

LP2 

LDA+ 

(ADDRl) 


LDQ+ 

(ADDR) 


STA+ 

(ADDR) 


STQ+ 

(ADDRl) 


RAO* 

ADDRl 


LDA* 

ADDR 


SUB 

=N1 


STA* 

ADDR 


SUB 

=N$3000 


SAM 

3 


JMP* 

LP2 

ADDRl 

0 

0 

ADDR 

0 

0 


JMP* 

(CHNG) 


From what core 


From what core 


From which core 
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SHIFTS 


O 


ppSHIFT A 
SHIFT LEFTi'-^i^pSHIFT Q 
F=0 F1=F m SHIFT COUNT 

rrrrrr rrrrrrrrrrrrrrrrrr iw r*-rrr 


LEFT SHIFTS 
C ALS (A) LEFT 

A QLS (Q) LEFT 

E LLS (QA) LEFT 


t 


RIGHT SHIFTS 
4 ARS (A) RIGHT 
2 QRS (Q) RIGHT 
6 LRS (QA) RIGHT 


^ DELAY * 

8 NOP 1. 1+SHIFT COUNT (. 1) * 

* 


oi 

to 
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5. 3 SHIFT CLASS INSTRUCTIONS 

These instructions are used to shift the data bit by bit either in the A register or the Q 
register singly or together. The data can be shifted either left or right bit by bit. For 
these instructions the format appears below: 


15 

12 

11 

8 

7 

6 

5 

4 

3 


0 

0 0 0 0 

1111 

1 

1 



c 

F=0 


F1=F 


i 

A 

i 

V 


.. 

/ 


Shift Count 


l=shift left _ 
0=shift right 


l=shift A 


l=shift Q 


Notice the shift count is five bits allowing a shift either way a maximum of 31 positions. 
The upper bit of the shift coimt will appear in the hex code as part of the second digit. 
For example, a 0F51 is an ARS ;^^instruction, not ARS 1. 

Left shifts are end around; the high order bit of the register is shifted around and into 
the low order bit of that register for single register shifts. For a double register shift, 
(Long Shift), the Q register is considered the most significant register and the A register 
the least significant register and on left shifts the high order bit of Q is shifted around 
into the low order bit of A. High bit of A is shifted left into the low order bit of Q. 

Right shifts are end off with sign extension. Bits shifted off the right end are lost, and 
the sign bit of the register is extended from the left. For long right shifts, the low bit 
(Bit 0) of Q is shifted into the high bit (Bit 15) of A and the sign (Bit 15) of Q is extended 
from the left. 

The mnemonics for the instructions in this class are: 


ARS 

A Right Shift 

QRS 

Q Right Shift 

LRS 

Long Right Shift (QA) 

ALS 

A Left Shift 

QLS 

Q Left Shift 

LLS 

Long Left Shift (QA) 
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5.3 


Example: 


Location 


Opcode 

I 

ALS 


Address 

I 

8 


Comments 


If the A register contained F302, execution of this instruction would 
shift the A register left 8 bits leaving 02F3. The high order bits of A 
moved end around into the low order bits of A. 

I i 

LRS 8 


If Q=8000 and A=AOFO, execution of this instruction extends the sign 
of Q to the right and the lower 8 bits of A would shift end off and be 

lost. Result is FF80|in Q, and OOAO m A. 

I I 

Illegal LLS 40 Maximum number of shifts 

j I allowed is 31, 

Legal QRS 0 Is effectively a no opera- 

I 1 tion 


5. 3. 1 Timing for Shift Class histructions 

The time for shift class instruction execution is: 


For long shifts (QA 
For single register 


together) 1. 1 + . 2 x shift count 
shifts (Q or A) 1. 1 + . 1 x shift coimt 
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INTERREGISTER 

LX 

F=0 Fl=8 PR AQM AQM 

ADDER CONTROLS^r*’ I + 1 + | l^l*" DESTINATION REGISTERS 

rrORIGIN REGISTERS 
r^OPERAND TWO 
irr^OPERAND ONE 


TRANSFER COMPLIMENT 


SUM 


80 

SET 

-0r^A,Q,M 

30 

AAQ 

(A)+(Q)(*-A,Q,M 

60 

TCA 

(A)NOT(^A,Q,M 

28 

AAM 

(A)+(M)f*A,Q,M 

50 

TCQ 

(Q)NOT]*"A,Q,M 

38 

AAB 

B+(A)|TA,Q,M 


cn 

w 


* 

* 

* 

* 

* 

* 

* 

* 

* 


?t= 

TRANSFER 


* 

40 

CLR 

0l*"A,Q,M 


AO 

TRA 

(A)r*-A,Q,M 

* 

90 

TRQ 

(Q)t*A,Q,M 

* 

88 

TRM 

(M)I*-A,Q,M 

* 

98 

TRB 

Br*A,Q,M 

* 

EXCLUSIVE OR 

* 

70 

E AQ 

(A)MQ>rA,Q,M 

* 

68 

EAM 

(A)V(M)(*-A,Q,M 

* 

78 

EAB 

BV(A) |— A, Q, M 


* 


48 TCM (M)NOTf*"A,Q,M 
58 TCB B NOTr*^A, Q,M 

LOGICAL AND 
BO LAQ (A)A(Q)f^A,Q,M 
A8 LAM (A)A(M)f^A,Q,M 
B8 LAB BA(A)f^A, Q,M 


* 

* 

* 

COMPLIMENT LOGICAL AND * 
FO CAQ ((A)A(Q))NOTf*^A,Q,M 
E8 CAM ((A)A(M))NOT|^A, Q, M 
F8 CAB (BA(A))NOTf^A,Q,M * 

* 


* B=INCLUSIVE OR OF (M)AND(Q). 


* 


r ^ 

V / 
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5.4 INTERREGISTER CLASS INSTRUCTIONS 

This class of instructions performs arithmetic or logical manipulation with the contents 
of A, Q or M or any combination of the three. The format for this class of instruction is: 


Operand 1 



Registers Registers 

Since the adder can operate on only two operands and there are three possible origin 
registers, these three origin registers are considered as two operands, operand 1 and 
operand 2. Operand 1 includes bit 5 or the A register bit and it can have two forms: 

A (Bits) - Operand 1 

0 - FFFF 

1 - Contents of A 

If this bit 5 is a 0, then all I’s are used as an operand and if bit 5 is a 1, then the contents 
of A is an operand. 

Operand 2 is the combination of bits 3 and 4 or the combination of the Q and M register 
bits : 


Q (Bit 4) 
0 
0 
1 
1 


M (Bit 3) 
0 
1 
0 
1 


Operand 2 
FFFF 
(M) 

(Q) 

Inclusive OR of Q & M 


If neither of these registers is specified, then all I’s are used as the operand. If any one 
but not the other is specified, then the contents of that specified register is used. If both 
Q and M are specified, then the inclusive OR of Q and M is used as Operand 2. The bit 
by bit truth table for the inclusive OR is: 


A 

1 

1 

0 

0 


B 

1 

0 

1 

0 


AV B 

1 

1 

1 

0 


Here a bit in either position yields a bit in the result. 
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Either A, Q or M, or any combination of these can be specified as the destination reg- 
isters. These are listed in any order and separated by commas in the address field. 

Since M is the interrupt mask register, the interregister instruction with M as a desti- 
nation register must itself be protected if the protect switch on the programmer’s panel 
is on. Otherwise, a protect fault will occur. 

Formation of the operation itself comes from bits 6 and 7 of the instruction word. The 
operations possible are: 

LP (Bit 7) XR (Bit 6) Operation 

0 0 Arithmetic Sum 

0 1 Exclusive OR 

1 0 Logical Product 

T 1 Complement Logical Product 

Refer back to Section 5. 1. 2. 3 of this chapter for the truth tables of the logical product 
and the exclusive OR. All the possible combinations of different instructions in this class 
using these two operands number 22. The mnemonics assigned with the instructions in 
this class are: 


SET 

Set to I’s 

CLR 

Clear to ”0" 

TRA 

Transfer A 

TRM 

Transfer M 

TRQ 

Transfer Q 

TRB 

Transfer Q V ^ 

TCA 

Transfer Complement A 

TCM 

Transfer Complement M 

TCQ 

Transfer Complement Q 

TCB 

Transfer Complement Q V M 

AAM 

Transfer Arithmetic Sum A, M 

AAQ 

Transfer Arithmetic Sum A, Q 

AAB 

Transfer Arithmetic Sum A, Qv M 

EAM 

Transfer Exclusive OR A, M 

EAQ 

Transfer Exclusive OR A, Q 

EAB 

Transfer Exclusive OR A, Q V M 

LAM 

Transfer Logical Product A, M 

LAQ 

Transfer Logical Product A, Q 

LAB 

Transfer Logical Product A, Q VM 

CAM 

Transfer Complement Logical Product A, M 

CAQ 

Transfer Complement Logical Product A, Q 

CAB 

Transfer Complement Logical Product A, Q V M 
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5.4 


Examples : 


o 



LDA 

=NO 

Clears A 



CLR 

A 

So does this 



CLR 

A,Q,M 

Clears A, Q and M 


AAQ 

A 

Adds A to Q, 

puts result in A 


TCA 

Q 

Puts complement of A into Q 


TRA 

Q,M 

Transfers A to Q and M 


SET 

M 

Set M to all 1 

's 


AAQ 

0 

Only affects overflow indicator — 
adds A and Q, puts result nowhere 

Problem: 





The following is 

an example of how 

a subroutine can pick up parameters from the calling 

routine. How does the subroutine pick up the parameters? Does it pick up the actual 

argument or the address of the argument? 



Calling Program; 

1 





LDA 

=XX 




STA 

ARGl 




LDA 

=XY 




STA 

ARG2 




LDA 

=XZ 




STA 

ARG3 


$500 


RTJ 

SUB 


$502 

ARGl 

0 

0 

Address of X 

$503 

ARG2 

0 

0 

Address of Y 

$504 

ARG3 

0 


Address of Z 

$700 

X 

NUM 

10 

X data 

$701 

Y 

NUM 

12 

Y data 

$702 

Z 

NUM 

6 

Z data 


Addresses of parameters fall directly beneath the call to the subroutine. 
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Subroutine: 

SUB 

0 

0 


STA* 

SAVEA+1 


STQ* 

SAVEQ+1 


LDA- 

$FF 


STA* 

SAVEI+1 


LDA* 

SUB 


EOR 

=N$8000 


STA* 

SUB 


LDA* 

(SUB) 


STA* 

SUBAGl X-' 


RAO* 

SUB 


LDA* 

(SUB) 


STA* 

SUBAG2 


RAO* 

SUB 


LDA* 

(SUB) 


STA* 

SUBAG3 


LDA* 

SUB 


INA 

I 


AND 

=N$7FFF . 


STA* 

SUB 

SAVE I 

LDA 

=N0 


STA- 

$FF 

SAVEQ 

LDQ 

=N0 

SAVEA 

LDA 

=N0 


JMP* 

(SUB) 

SUBAGl 

BSS 

SUBAGl (1) 

SUBAG2 

BSS 

SUBAG2(1) 

SUBAG3 

BSS 

SUBAG3(1) 



5.4 


Problem: 

How many numbers does the following routine sort? In what order? From what core 
locations ? 


SORT 

CLR 

A 


STA- 

$FF 


ENQ 

1 

BEGIN 

LDA+ 

$500, Q 


SUB+ 

$500,1 


SAP 

CHECK-*-! 


LDA+ 

$500, Q 


STA* 

TEMP+1 


LDA+ 

$500,1 


STA+ 

$500, Q 

TEMP 

LDA 

=NO 


STA+ 

$500,1 

CHECK 

INQ 

1 


TRQ 

A 


EOR 

=N$10 


SAZ 

1 


JMP* 

BEGIN 


LDA- 

$FF 


INA 

1 


STA- 

$FF 


EOR 

=N$F 


SAZ 

EXIT-*-! 


ENQ 

! 


ADQ- 

$FF 


JMP* 

BEGIN 

EXIT 

SLS 
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* REGISTER REFERENCE * 

* F=0 FI DELTA * 

* rr*“i^i^r*'i^r*r*r^r*’r*‘r^r**r*r*‘UU r*‘r‘r*‘r*“r*r*r*r*' * 


* 

t 

ARITHMETIC 


t 

INTERRUPT 

1 

PROTECT 


I/O 

* 

* 

t 




t 





i 


* 

* 

A 

ENA 

. +-DELTA 

A 

4 

EIN* 

ENABLE 

7 

CPB 

CLEAR 

2 INP 

l/O^A 

* 

* 

C 

ENQ 

+-.DELTA 

Q 

5 

IIN 

INHIBIT 

6 

SPB 

SET 

3 OUT 

(A)(^l/0 

* 

* 

9 

INA 

+-DELTA+(A) \^A 

E 

EXI* 

EXIT 

0 

SLS 

SELECTIVE 

STOP 


* 

* 

D 

INQ 

+-DELTA+(Q)f*"Q 




B 

NOP 




* 


* *ONE INSTRUCTION DELAY * 
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5.5 REGISTER REFERENCE CLASS INSTRUCTIONS 


All the instructions in the class are one-word. The F field is always a zero and the FI 
field will signify the particular instruction within this class. The format for the Register 
Reference Class of instructions is: 


F=0 

FI 

A 

Instruction ' 
Code 

L 


The instructions within this class are: 
FI 


0 

SLS 

Selective Stop 

1 


SKIPS 

2 

INP 

Input to A 

3 

OUT 

Output from A 

4 

EIN 

Enable Interrupt 

5 

IIN 

Inhibit Interrupt 

6 

SPB 

Set Program Protect 

7 

CPB 

Clear Program Protect 

8 


INTERREGISTER 

9 

INA 

Increase A 

A 

ENA 

Enter A 

B 

NOP 

No operation 

C 

ENQ 

Enter Q 

D 

INQ 

Increase Q 

E 

EXI 

Exit Interrupt State 

F 


SHIFTS 



The A field is available in this class of instructions. 

5. 5. 1 Instructions ENA, INA, ENQ and INQ 

These four instructions are used to either enter into or increase the A register 
or the Q register by the value in A • This value is signed allowing numbers of 
the magnitude plus or minus 127. 

Example: 


LDA 

=N22 

Loads A with 16 

ENA 

22 

So does this 

SUB 

=N$1 

Decreases A by 1 

INA 

-1 

So does this 
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5.5.1 


Where applicable, these instructions should be used in place of storage reference 
class with constant mode as these take only one word and 1.1 microseconds to 
execute. 

The value in the address field is placed into A by the assembler. The ENA 22 
machine instruction equivalent is 0A16. 

5. 5. 2 Instructions SPB and CPB 

These instructions are used to either set or clear the protect bit (Bit 17) in mem- 
ory. For these instructions A is not used. The address of the core location 
which will have its protect bit either set or cleared must be in the Q register. If 
the program protect switch on the programmer panel is on, then these instructions 
must be protected. Otherwise, a program protect fault (interrupt on line 0, pro- 
tect fault indicator on panel) will occur and these instructions become no operations. 

Example: Clear the protect bits in core from 1000 to 2000. 


TEMP 

0 

0 


START 

LDQ 

=N$1000 


LOOP 

CPB 


Address is in Q 


INQ 

1 



STQ* 

TEMP 



ADQ 

=N-$2000 



SQZ 

DONE-*-l 

Finished? 


LDQ* 

TEMP 

No 


JMP* 

LOOP 


DONE 

- 

- 

Yes 



This particular routine is further simplified with the use of interregister class 
instructions. 


Problem: The CLRPB subroutine clears protect bits on what core area? 

Calling Program 

RTJ CLRPB 

LWA NUM $4000 

FWA NUM $2000 
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Subroutine 


CLRPB 

0 

0 


STQ* 

TEMPQ+1 


STA* 

TEMPA+1 


LDA 

=X$7FFF 


SUB* 

(CLRPB) 


RAO* 

CLRPB 


LDQ* 

(CLRPB) 


SOV 

0 

LOOP 

CPB 



INQ 

1 


AAQ 

0 


SOV 

DONE-*-l 


JMP* 

LOOP 

DONE 

RAO* 

CLRPB 

TEMPQ 

LDQ 

=NO 

TEMPA 

LDA 

=NO 


JMP* 

(CLRPB) 



5. 5. 3 Instructions EIN and IIN 

These instructions are used to either enable the interrupt system or inhibit the 
interrupt system. If the program protect switch on the programmer’s panel is 
on, these instructions must be protected. Otherwise, a protect violation will 
occur. The interrupt system is inhibited immediately upon execution of the IIN 
instruction. However, for the EIN instruction one free instruction is allowed 
before the interrupt system becomes enabled. 


Example: 




MAIN 

RTJ 

SUB 


SUB 

0 

0 



IIN 


Interrupt System inhibited 


EIN 




JMP* 

(SUB) 

This instruction is free. 


This subroutine will operate on any level without interference from any other level 
since the whole subroutine functions with the interrupt system off. Control is 
returned to the main program before the interrupt system is activated through 
use of the one free instruction following the EIN. 
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For example, if an internal interrupt occurred on line 0, P and the overflow indi- 
cator of the interrupted program would have been saved in word 0 of the trap for 
line 0 (location $100). Control would have been transferred to word 1 (location 
$101). If word 1 contained a jump to the Internal Interrupt Processor, that routine 
would be executed. It would determine the cause of interrupt (program protect 
violation or parity error) by using the appropriate instructions (skips). Then the 
routine could exit back to the interrupted program. It would do that by; 

EXI 00 

The delta in the EXI instruction should be the lower 8 bits of the word 0 trap lo- 
cation for the appropriate line. In this case, the 00 means the trap for line 0, at 
address $100. 



line 0 


exit through here 


The EXI instruction (Exit Interrupt State) is used to exit from an interrupt sub- 
routine. It restores the overflow indicator to its previous state, resets P of the 
interrupted program, and enables the interrupt system. 

5.5.4 Instructions INP and OUT 

The INP and OUT instructions are used for all input and output operations on the 
1700. They are used to input or output data to or from the A register. They out- 
put function codes to the peripheral equipment from the A register, and they input 
status conditions of the equipment to the A register. The Q register is used to 
address the desired equipment. A brief introduction to I/O using these instructions 
is contained in Chapter 7. 

5. 5. 5 Instructions SLS and NOP 

The SLS or selective stop instruction is dependent upon the positioning of the 
selective stop switch on the programmer’s panel. If the selective stop switch is 
up, then the program will stop on this instruction. If the selective stop switch is 
not up, then this instruction is the same as a NOP or No Operation Instruction, 
where the computer simply steps past this instruction without performing any op- 
eration. If the computer stops, program execution will continue by momentarily 
setting the RUN- STEP switch on the programmer’s panel to the RUN position. 


5-44 




5.5.5 


Example: 




START 

LDA 

=N$1000 



NOP 


Put infer future expansion 


NOP 




SLS 


p 

Program stops ig stop 


- 


switch is up 


- 


Continues when run switch 


- 


is hit or if stop switch 


- 


is not up. 

Problem: 





The following is a conversion routine which converts a positive or negative hexa- 
decimal number in the A register to the ASCII codes for the decimal number. It 
consists of a CONVRT subroutine and a main program CONTST which was used to 
check it out. 

Study the program carefully, see how the conversion is done and how the param- 
eters are passed. 

This should be considered a final examination over the 1700 instructions and their 
use. 
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5 . 5.5 


0001 NAM CONVRT 


0002 

POOOO 

0001 


BSS 

SAVEQ ( 1 ) ♦ SAVEI ( 1 ) * SAVEA ( 1 ) 


POOOl 

0001 





P0002 

0001 




0003 

P0003 

0003 

BUF 

8SS 

BUF(3) 

0004 

P0006 

0006 

BUFl 

BSS 

BUFl (6) 

0005 

POOOC 

0028 

SIGN 

NUM 

$28*S2D 


POOOD 

0020 




0006 

POOOE 

0030 

TAB 

NUM 

$30*$31*$32»$33*$34*$35»$36*$37*$38*$39 


POOOF 

0031 





POOlO 

0032 





POOH 

0033 





P0012 

0034 



i 


P0013 

0035 



i 


P0014 

0036 





P0015 

0037 



i 


P0016 

0038 



i 


P0017 

0039 



1 





ENT 

CONVRT 

0008 

P0018 

0000 

CONVRT 

0 

0 I 


isixins 

48F6 


STO* 

SAVEQ j 

0010 

POOIA 

EOFF 


LDQ- 

-I 1 

0011 

POOIB 

48E5 


STQ* 

SAVEI ! 

0012 

POOIC 

0842 


CLR 

Q 1 

0013 

POOID 

40FF 


STO- 

I ! 

0014 

POOIE 

0122 


SAP 

POS i 

0015 

POOIF 

ODOl 


I NO 

1 i 

0016 

P0020 

0864 


TCA 

A 

0017 

P0021 

EAEA 

POS 

LDQ* 

SIGN*Q i 

0018 

P0022 

48E8 


STQ* 

BUFl+5 1 

0019 

P0023 

E8EA 


LDQ* 

TAB+0 ! 

0020 

P0024 

48E1 


STQ* 

BUFl i 

0021 

P0025 

EOOO 


LDQ 

-N$20 j 


P0026 

0020 



i 

0022 

P0027 

48DF 


STQ* 

BUFl+1 

0023 

P0028 

48DF 


STQ* 

BUFl+2 1 

0024 

P0029 

48DF 


STQ* 

BUFl+3 ! 

0025 

P002A 

48DF 


STQ* 

BUFl+4 

0026 

P002B 

0842 

LOOP 

CLR 

0 i 

0027 

P002C 

0106 


SAZ 

OUT 

0028 

P002D 

3000 


DVI 

=N10 


P002E 

OOOA 




0029 

P002F 

EADE 


LDQ* 

TAB*Q 

0030 

P0030 

4905 


STQ* 

BUFl* I 

0031 

P0031 

DOFF 


RAO- 

I 1 

0032 

P0032 

18F8 


JMP* 

LOOP i 

0033 

P0033 

40FF 

OUT 

STQ- 

I ! 

0034 

P0034 

0C05 


ENQ 

5 

0035 

P0035 

CADO 

BACK 

LDA* 

BUFHQ ! 

0036 

P0036 

0FC8 


ALS 

8 i 

0037 

P0037 

ODFE 


INQ 

-1 

0038 

P0038 

8ACD 


ADD* 

BUF1*Q 

0039 

P0039 

69C9 


STA* 

BUF* I 

0040 

P003A 

DOFF 


RAO- 

I 1 

0041 

P003B 

ODFE 


INQ 

-1 

I 
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00A2 

P003C 

0171 

SOM 

DONE 

0043 

P003D 

18F7 

JMP<^ 

BACK 

0044 

P003E 

E8C1 DONE 

LDQ^ 

SAVEO 

0045 

P003F 

C8C1 

LOA* 

SAVEI 

0046 

P0040 

60FF 

STA- 

I 

0047 

P0041 

P0042 

COOO 
0003 P 

LDA 

= XBUF 

0048 

0049 

P0043 

1C04 

JMP<^ 

END 

(CONVRT) 


J OOFF SAVEQ OOOOP SAVEI OOOIP SAVEA OOQgP BUF 0003P 

8UF1 0006P SIGN OOOCP TAB OOOEP CONVRT 0018P POS 0021P 

LOOP 002RP OUT 0033P BACK 0035P PONE 003EP 




CONTST 

2BB5 

CONVRT 

2BC8 


TTY 

Output 


r 

PP 

* 


MI 


*p 

J 

*ASSEM 


OPTIONS LX 



*P . 
J 


*L,5 

J 

*X,, 

+14272 M Answer 
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0001 NAM CONTST 

0002 ENT CONTST 

0003 EXT CONVRT 

0004 POOOO 0000 CONTST 0 0 

0005 POOOl COOP LDA =N$37C0 

P0002 37C0 

0006 P0003 5400 X RJJ CONVRT 

P0004 7FFF X 

0007 POOPS 6800 STA WRITER-6 

P0006 0007 


0008 P0007 54F4 WRITE RTJ- ($F4) 


0009 P0008 OCOl NUM SOCOl 

0010 P0009 OOOF P ADC COMPL 


0011 POOOA 0000 NUM 0 

0012 POOOB 18FC NUM S18FC 

> Writes answer 

0013 POOOC 0003 NUM 3 

0014 POOOD 0000 ADC 0 


0015 POOOE 14EA JMP- (SEA) 

0016 POOOF 0161 COMPL SOP EXIT 


0017 POOlO 18FF NUM S18FF 

0018 EXIT EXIT 

0018 POOH 54F4 

0018 P0012 OAOO 



0019 END CONTST 







I 

OOFF CONTST OOOOP WRITE 

0007P COMPL 

OOOFP EXIT 

OOllP 


CONVRT 0004X 
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5.6 EXERCISES 

5.6.1 Exercises - Constant Mode of Addressing 

1. What is in the A and Q registers when location NEXT is reached? 



LDA 

=N$1F0C 



ALS 

3 



LDQ 

=N277 



LRS 

12 



EOR 

=N$0106 


NEXT 

. 

— 



LDA 

=N$7FFF 



LDA 

=N 6 



MUI 

=N 6 


NEXT 

— 

— 



LDQ 

=AAB 

See Appendix E for 


LDA 

=AXY 

ASCII conversions. 


AND 

=ACD 



LLS 

16 



AND 

=AWZ 


NEXT 

— 

— 



5.6.2 Exercises - Absolute Mode of Addressing 

1. Write code to increase the contents of Index Register I by 103 ^ 0 . 


2. If C017 is in core location 3F, and 4016 is in core location 4017, where would 
program control be given for: 


a) JMP- ($3F) 

b) JMP- $3F 

c) JMP+ ($3F) 


3. What is wrong with these: 

a) LDA- 

b) LDA+ 

c) LDA+ 


0 

$7F3-$700 

(TEST) 
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5. 6. 3 Exercises - Relative Mode of Addressing 


1. Will these instructions address backward or forward, and how many locations 
from P? 

a) 1831 

b) 1800 
EFFF 

c) 18FE 

2, What modes of address are these assembly language instructions? 


a) 

LDA 

TASK 

b) 

JMP- 

($44) 

c) 

RAO+ 

(HIND) 

d) 

STA* 

*+3 

e) 

AND 

=X$4111-4111 

f) 

STQ 

(DRUM) 

g) 

LDA 

=XTWIX 

h) 

LDA- 

10 


3. Why is relative addressing never used to address into the communications region? 


5.6,4 Exercises - Indexing 

1. What is wrong with these: 


a) 

b) 

c) 


LDA AB, Q, I 

MUI A,Q 

ALS 0,Q 


2. What number is in A when NEXT is reached: 


Core Location Contents 


0022 - 

0023- 

0024- 


0000 

8024 

0023 
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a) 

LDQ 

=N$-1 


LDA- 

($23), Q 

NEXT 

— 

— 

b) 

LDQ 

=N$24 


LDA- 

($22), Q 

NEXT 

— 

— 

c) 

LDQ 

=N$1 


LDA 

$23, Q 

NEXT 

— 

— 

What i s wrong with this program: 
NAM 


START 

LDA 

=N$10 


STA- 

I 


LDA+ 

$2000 

LOOP 

SUB+ 

$2000, I 


LDQ- 

I 


ADQ 

=N-1 


SQZ 

DONE-* 


JMP* 

LOOP 

DONE 

— 

— 


5.6.5 Shift and Skip Instructions 

1. What will these machine language instructions do: 

a) OFFO 

b) 01A3 

c) OF52 

d) OF88 

2. What will be in the Q and A Registers when this program jumps to OVER. 


Location 

Opcode 

Address 

Comments 

START 

LDA 

=N$738F 

Loads 738F in A 


LDQ 

=N$01CA 

Loads OICA in Q 


LLS 

3 



QRS 

14 



ALS 

5 



SQM 

GO-*-l 



ARS 

2 



SAM 

GO-*-l 



ALS 

2 



QRS 

3 


GO 

JMP 

OVER 
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5. 6. 6 Review Exercises 

1. Switch the contents of Location 1000 into Location 1001, and vice versa: 
TEMP 0 0 


LDA+ 

$1000 

STA* 

TEMP 

LDA+ 

$1001 

STA+ 

$1000 

LDA* 

TEMP 

STA+ 

$1001 


Several points of note: 

1. The problem descriptions seldom, if ever, specify core locations in decimal; 
they’re assumed to be hexadecimal since rarely is a corelocation referenced 
decimally. Therefore, 1000 and 1001 in the problem mean 1000 hex and 1001 
hex. 

2. The TEMP location is necessary for switching to hold the one operand while 
the other is being switched. This form TEMP 0 0 can be used to simply 
define a core location; one cell is reserved and zero’s placed therein. 

3. The one-word relative mode of addressing is used for locations within the 
range ofjLl27 to save one core location and one cycle time, and also to allow 
the program to be run anywhere. 

4. Two-word absolute mode of addressing is used for the core locations 1000 & 
1001. This is because this program could be finally loaded any number of 
core locations away from 1000 and 1001; therefore, a two-word instruction 
is needed. But why use absolute mode instead of relative? For programming 
"run anywhere" programs there are two basic rules: 

a) Everything that will move with the program is to be coded using relative 
mode; 

b) Everything that remains fixed in core is to be coded using absolute mode. 

Since the statement of the problem states the two fixed core locations to be 
switched regardless of where the program doing the switching is to be loaded, 
references to 1000 and 1001 should be made using absolute mode. 
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2. Transfer the contents of core locations 1000 through IFFF to 3000 through 3FFF. 


START 

LDQ 

=X$1FFF-$1000 


LOOP 

LDA+ 

$1000, Q 



STA+ 

$3000, Q 



INQ 

-1 



SQM 

DONE-*-l 



JMP* 

LOOP 


DONE 

- 

— 


Do a reverse transfer of problem 2, 

i. e. , place contents of 1000 in 3FFF, 1001 

in 3FFE, etc. 




START 

LDQ 

=X$1FFF-$1000 



CLR 

A 



STA- 

I 


LOOP 

LDA+ 

$1000,1 



STA+ 

$3000, Q 



RAO- 

I 



INQ 

-1 



SQM 

DONE-*-l 



JMP* 

LOOP 


DONE 

- 

- 


For this problem, 

two index registers are needed, 

one indexing up (I) , and one 

indexing down (Q). 




Do Example 2 without Index Registers: 



NAM 

EXAMP 


AREAl 

ADC 

0 


AREA2 

ADC 

0 


COUNT 

NUM 

0 

NUM sets the number 0 


LDA 

=X$7FFF-$1FFF+$1000 


STA* 

COUNT 



LDA 

=N$1000 

First Address in AREAl 


STA* 

AREAl 



LDA 

=N$3000 

First Address in AREA2 


STA* 

AREA2 


LOOP 

LDA* 

(AREAl) 

Indirect Addressing 


STA* 

(AREA2) 



RAO* 

AREAl 



RAO* 

AREA2 



RAO* 

COUNT 



SOV 

DONE-*-l 



JMP* 

LOOP 


DONE 

- 

- 
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Several points to note: 

1. The number prestored in location COUNT is the difference between the 
largest pos s ible positive number 7FFF and the difference between the be- 
ginning and end of the core blocks. If we increase this count by one each time 
through the loop, we will encounter an overflow condition when the count 
changes from 7FFF to 8000. We can then loop through and exit from the loop 
using this preset count. 

2. AREAl and AREA2 are preset by using the ADC pseudo-op to 0. Formerly 
the form AREAl 0 0 was used to perform the same function. The assembler, 
when encountering a zero in the opcode field, treats it as an ADC pseudo- op 
so both forms are equivalent. 

3. This method of solving the problem is absolutely dependent on the use of in- 
direct addressing since the addresses must be contained and manipulated in 
core cells. 
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6.0 INTRODUCTION 


The 1700 has 3 assemblers: 

• Basic assembler, which operates as a stand-alone system in a 4-K computer 

• Utility assembler, which operates under the utility system and re quire s an 8-K 
computer 

• Macro assembler, which operates under the mass storage operating system and 
requires a 12-K computer 

The standard pseudo ops covered in this chapter are available under all 3 assemblers, 
with the exception of some additional pseudo ops available only under the macro assem- 
bler. These are noted where they are described. 

hi addition to the mnemonics for the machine instructions which we have covered, there 
are certain instructions that are only recognized by the assembler. They are used by the 
assembler itself to control the assembly, control the data, reserve storage, convert 
data, signify beginning and end of assembly and control the output listing. These in- 
structions are called pseudo instructions or pseudo ops. 


6.1 NAM 

The first instruction on any source program must be the pseudo instruction NAM. Its 
use is to signal the assembler when to begin assembly and how to set up its program 
counter for this assembly. Its form is: 

Location Opcode Address Comments 

NAM Name 

If the location field is blank, the assembler will begin assembly with its counter at zero 
and signal to the loader in the object program that this program is program relocatable. 
This provides the ability to have the source program assemble without regard to where 
the program will finally be loaded and run in core. If a hexadecimal number appears in 
the location field, the assembler sets its program counter to that value and assembles 
the program absolutely. When a program of this type becomes loaded, it is 1 oaded be- 
ginning at this absolute address specification, hi the address field of the NAM pseudo op 
will be the program name which is reproduced on the output listing. 
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Example: 


NAM 


SORT 


This program is assembled program relocatable and can be loaded anjrwhere into core. 
The name SORT will appear on the output listing, 

$100 NAM INTERRUPT 


This program is assembled absolutely, beginning at 100 hex, and will be loaded into core 
at 100 hex only. 

6,2 END 

The last instruction in the program must be an END pseudo instruction. It marks the 
physical end of the program. The address field may contain an entry point to the pro- 
gram. This is called a named transfer address, and it is the entry point where it is 
desired for execution to begin after the object program is loaded. 

Example: 

NAM SORT 

ENT START 

START 


END START 


6.3 ENT, EXT 

Two pseudo instructions are used to provide communication between programs. They 
are the ENT (entry point) pseudo instruction, and the EXT (external point) pseudo in- 
struction. Those locations internal to a program that are needed in another program 
are declared as entry points to the immediate program. The other program can then 
refer to these entry points in its immediate program by declaring them as external. The 
names must match identically. Since communication between these two programs can 
not be made at assembly time (since both programs can be assembled at different locations 
at different times), the relocating linking loader must provide the correct location ad- 
dresses when these two programs are finally loaded together. To accomplish this, the 
loader builds loader symbol tables (Figure 13) where it places references to all entry 
points and external points. These tables locate exactly for the loader where the entry 
point addresses are and where the external point references are that need patching with 
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their corresponding entry point addresses. When it finds a match in names between an 
entry point and an external point, it does the patching. 

Example: 

Program 1 is written and it needs to extract data from program 8 which has not 
yet been written. The writers of both programs agree to a 10 word area with the 
name of CLARK. Since program 1 needs to refer to CLARK in p r ogr am 8, it de- 
clares CLARK as an external. This external declaration allows the assembler the 
use of this symbol which is not otherwise defined in program 1. 

NAM PROGl 

EXT CLARK 


LDA+ CLARK 

Program 8, when it is finally written, will declare CLARK as an entry point. 

NAM PROG8 

ENT CLARK 


BSS CLARK(IO) 


When both of these programs are finally loaded together in core, the loader will 
link the address of CLARK at program 8 to its correct reference in program 1. 

The EXT described above is called an absolute external. It means references made 
from the program to the external are assembled in absolute form (even if a relative 
mode is used in the instruction). 

More than one symbol can be defined with each ENT and EXT instruction, since their 
general form is: 


EXT Hl,n2, 

ENT 

n - name 


r 
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6.4 EXT* 

Another form of external is available under the macro assembler: the relative external. 
It causes the loader (at load time, when linking is done) to patch in the relative distance 
from the referencing instruction to the location of the external, rather than the absolute 
core location. This allows the use of relative references. 



Example: 

e:^t* 

1 

TAG 

5800 

1 

RTJ 

TAG 


7FFFX I 

I 

A two-word relative mode must be used in referencing these externals. 


6.5 EQU 

It is common to use symbols in place of constants or known address locations. The 
EQU pseudo instruction provides a means of declaring to the assembler the equivalence 
of a symbol with a number or expression. The form of EQU is: 

Location Opcode Address Comments 

EQU ONE(l), TWO(2), THREE(3) 

The symbol with its equivalent numb e r is placed in the assembler’s symbol directory 
and all references to that symbol will yield its equivalent number. It is important to 
note that the EQU does not generate any code; it simply tells the assembler another value 
for symbols found in the program. For example, it uses a 2 wherever it sees the name 
TWO. 

Example: Count the number of times the exact bit configuration 1110 appears in bit 

positions 4 to 7 of core locations 1000 to lOCE. 



NAM 

FIND 


COUNT 

0 

0 



EQU 

o 

o 

o 

MASK2($00E0), FIRST($1000) 


EQU 

LAST($10CE) 


START 

LDQ 

=XLAST-FIRST 


LOOP 

LDA+ 

FIRST, Q 



AND 

=NMASK1 

And out all but bits 4 thru 7. 


EOR 

=NMASK2 

Look for exact match. 


SAN 

OVER-*-l 

Was match not exact ? 


RAO* 

COUNT 

No, match was exact. 

OVER 

INQ 

-1 

Yes, no match. 


SQM 

DONE-*-l 

Finished ? 


JMP* 

LOOP 

No. 

DONE 

- 

- 

Yes. 
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By using the EQU, the same general problem with different parameters could be solved 
with this program simply by changing the EQU card. Assume the problem looked for 
IOIIO 2 in bit positions 8 through 12 of core location 3020 through 3F21. Simply pull out 
the EQU card and insert one: 

EQU MASK2($1F00), MASK2($1600), FIRST($3020) 

EQU LAST($3F21) 

The EQU instruction is especially useful for referencing the mask tables in low core. 
(See Appendix I. ) These masks are available for foreground or background programs to 
use, rather than defining additional core locations in a program to contain masks. The 
EQU’s to be used would be as follows: 

EQU LPMASK($2), NZERO($12), ZERO($22) 

EQU ONEBIT($23), ZROBIT($33) 

These are the same EQU’s used by the system and they make it easier to remember 
which mask is being used. For example: 

LDA- LPMASK+2 

This can be used instead of: 

LDA- $4 

The same code is generated: C004 

It is easier to remember that LPMASK+2 is a mask location containing two one bits on the 
right end than to remember what location $4 contains. NZERO+4 would contain 4 zero 
bits on the right. Location ZERO always contains a 0 word. ONEBIT+5 would contain a 
one bit in bit position 5; ZROBIT+8 would contain a zero bit in bit position 8. 


6.6 NUM 

hi order to insert known constants into the assembly, the pseudo op NUM is used. Its 
form is: 


Location 

Opcode 

Address 

Comments 

s 

s means a symbol 

NUM 

0 

0 

0 



16-bit constants are inserted, in line, one constant to a word. If a symbol is specified 
in the location field, it is assigned the storage address of the first constant. 
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Example: 


HERE 


NAM 

NUM^ 


EXAM 

$7312, 21, -21, -$216 






Since this is a program relocatable assembly (blank in location field of NAM card), HERE 
is at program coimter POOOO and the following constants are inserted: 


POOOO- 

7312 

POOOl- 

0015 

P0002- 

FFEA 

P0003- 

FDE9 


Expressions are not allowed. 


NUM $7312-41 niegal 

6.7 ADC 

To insert in line a table of addresses, the ADC pseudo instruction is used. It functions 
identically to the NUM pseudo instruction except expressions may be used and the result 
is evaluated for only 15 bits since an address value cannot exceed 15 bits in length. Bit 
15 will be set if the expression is enclosed in parentheses (indicating an indirect refer- 


ence). Its form is: 




s 

ADC 

®1»®2 ®n 


Example: 




Location 

Opcode 

Address 

Comments 


NAM 

EXAM 



EQU 

TEN(IO) 



EQU 

MASK($F302) 


HAT 

ADC 

TEN 

TEN is OOOA (See EQU) 

STILL 

ADC 

(HAT) 

Will set Bit 15 


Assume the program counter for HAT is at P0102 and for STILL, POIFF; then: 


P0102 OOOA 

POIFF 8102 

6.8 ADC* 

Under the macro assembler there is a second form of the ADC pseudo op, the ADC* 
pseudo op. This form functions identically to the ADC pseudo op in the utility assembler. 
However, all address expressions evaluated are then placed in relative form. Exam- 
ples of both forms are on the following page. 
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HERE 


NAM 

BSS 

ADC 


EXAMl 

TAG(10) ,TAG1(10) 
TAG , TAGl 


6.8 


HERE which is at P0014 has the absolute address of TAG (POOOO), and HERE+1 (P0015) 
has the absolute address of TAGl (POOOA). 

NAM EXAM2 

BSS TAG(10) ,TAG1(10) 

HERE ADC* TAG, TAGl 

HERE, at P0014, has the relative address of TAG (FFEB, or twenty decimal locations 
back) and HERE+1 (P0015) has the relative address of TAGl (FFF5). 

6.9 ALF 

ASCII characters are stored in consecutive locations, two 8-bit characters for each core 
location, by the ALF pseudo instruction. The ALF pseudo instruction is used to pack a 
core area with a message which can be used for subsequent output to ASCII devices like 
the teletype. A symbol, if used in the location field, will refer to the first word of the 


block. The format for the ALF pseudo instruction is: 

s 

ALF 

n, <C2n characters^ 

Example: 




NAM 

EXAM 

HERE 

ALF 

3, ABACAD 


Three words are packed with the ASCII equivalents of ABACAD: 

POOOO 4142 

POOOl 4143 

P0002 4144 


Table of ASCII equivalents is found in Appendix E. 
A blank is stored into unused locations. 


Example: 





HERE 

ALF 

6, ABACAD 

produces: 

POOOO 

4142 



POOOl 

4143 



P0002 

4144 



P0003 

2020 



P0004 

2020 



P0005 

2020 
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The ALF pseudo op in the utility system only allowed specification for its message by the 
use of an unsigned integer for the number of core locations to be reserved, hi the macro 
assembler a second form for this pseudo op is available: 


ALF 


n, <^essag^n 


n may be a non-integer character which signals the end of the message, n is a delimiter 
and appears before the comma and after the message. 

This form is an advantage where the programmer does not desire to count the number of 
words in his message and will find no conflict between his message and the terminating 
character used. 


For either form the pseudo op ALF will pack two ASCII characters per word. The address 
of the first location of the message in core will be assigned to the symbol in the location 
field, if specified. 

Example: 


NAM EXAMP 

GO ALF Z,DATAZ 


Two words are reserved, starting at location GO for the ASCII equivalent of DATA. 

6.10 DEC 

A DEC pseudo op is available under the macro assembler. Suppose the following problem 
needed to be solved: 

y = 1. 63 X 10^ x^ + 21246 x 10"^ x + 81 x 2^ 

. 0074 X 106 . 11 X 10^ 


Insertion of the constants in this problem would be facilitated by having the assembler do 
the binary or decimal conversions. The DEC pseudo op allows insertion of constants with 
decimal or binary scaling factors. Its form is: 


s 

k is a constant - fDdBb 

DEC 

^1* ^2* * * * 

Example: 

NAM 

EXAMP 

HERE 

DEC 

163D1, 74D2, 21246D-2, 81B6, llDl 


This example shows the constants from the equation inserted. The decimal numbers are 
converted mentally to integers. HERE is the symbolic address of the first of these 
decimal constants which are inserted one per core cell. The size, then, of the converted 
decimal constants must lie within the range of ±32, 767. 
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6.11 VFD 


The VFD pseudo op is available under the macro assembler. It is frequently desirable 
to pack data into memory locations. The VFD (variable field definition) pseudo instruc- 
tion assigns data to consecutive locations in the instruction sequence without regard for 
computer words. Data is stored in bit strings rather than word units. Its format is: 


s 


VFD 




m n /v 
n n n 


m will specify the mode. Three modes are possible: 


N numeric constant 

A ASCII character code 

X expression 

n will specify the number of bits and v is the value, n may be 16 bits or less for either 
N mode or X mode; however, for A mode n must be some multiple of 8 since ASCII 
character conversion is meanmgless for a non-multiple of 8 bits. Numeric constants 
must be within the range of ±32, 767. 



Example using numeric constants: 

NAM EXAMP 

TAG VFD N4/$F, N8/6, N8/-6, N2/16 

LDA 



The assembly of the bit strings begins with the high order bit of the first core cell (in 
this example the core cell labeled TAG). TAG gets packed with 1111 which is the binary 
equivalent of hexadecimal F. The next 8 bits of TAG get packed with the binary equivalent 
of 6 which is 0000 0110. The next 8 bits (which will now be the lower four bits of TAG) and 
the upper four bits of TAG+1 get packed with -6 or 1111 1001. The next two higher order 
bits get packed with as much of the number 16 as is possible, that is, with the low order 
two bits (00). The remaining bits of TAG+1 set to zeros. TAG and TAG+1 will then look 
like this: 

TAG F06F- 1111 0000 0110 1111 

TAG+1 9000- 1001 0000 0000 0000 

If the number of bits specified is not sufficient for the value then the high order bits of 
the value are truncated (chopped off), as many as are necessary. If the number of bits is 
larger than the value, then the sign of the value is extended. 

Example using expressions: 

NAM EXAMP 

EQU TAG($4FF1), HAT(20) 

TOP VFD X8/TAG+2,X8/HAT 
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The previous example shows the use of expressions where the expression is evaluated 
absolutely (since neither TAG nor HAT is relocatable). If fewer than 16 bits are spec- 
ified, the absolute expression by itself is evaluated (using 16 bits) and is truncated. The 
previous example is decoded by the assembler. 

TOP F314 

When the expression is evaluated relatively, the n must be 15 and the expression must 

be positioned so that it will be stored right justified at bit position 0 of the computer word. 

Example using ASCII character mode: 

NAM EXAMP 

TAP VFD A24/ABC, N8/$3F 

The above example illustrates three ASCII characters. A, B and C; these will be con- 
verted using 8 bits for each, followed by the numeric constant 3F hex in the lower 8 bits 
of TAP+1. The above example is decoded by the assembler. 

TAP 4142 

TAP+1 433F 


6.12 BSS, BZS 

Blocks of data storage can be all ocated within the program using either the BSS or the 
BZS pseudo instructions. The block is given a name and a size accorduig to the following 
format: 


BSS 

n is name of block 
s is size 


m (s^),n^(s„), n (s ) 

l' 1'’ 2' 2'* m^ m' 


These pseudo instructions reserve areas. The BZS area is zeroed out at load time 
while the BSS block is not changed at load time; therefore, anything may be initially set 
in a BSS block at run time. 

Example: NAM EXAM 

BSS AA(IO), BB(20) 

LDA 


The symbol AA will be assigned the address of the first location of the block of 10 and 
the symbol BB will be assigned the address of the first location of the block of 20 loca- 
tions reserved. When this program is loaded, anything can be initially contained in these 
first 30 locations. Had a BZS been used instead of the BSS, these first 30 locations would 
have been zeroed at load time. 
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6.13 DAT, COM 

Two other pseudo ops are used to reserve areas for use that are outside the bounds of 
the main program. These areas are reserved by the DAT and COM pseudo ops. Refer 
to Figure 13. Notice that the common storage area (reserved by the COM pseudo instruc- 
tion) is the area that is used by the loader. This area cannot be preset with data and 
is used only at run time when the loader becomes destroyed. The data area (reserved by 
the DAT pseudo instruction) is assigned an area with the programs themselves; in fact, 
the data block will precede the program that declares it. The data area can be preset. 
The loader will make common and data area assignments just once and will use its com- 
mon coimter and data counter at this assigned value for the rest of the programs loaded. 
It is necessary, then, for the first subprograms of a run declaring common or data 
storage to declare the largest amount necessary. The format for the COM and DAT 
pseudo instructions is the same as for the BSS and BZS and is: 


Example: 



DAT 

n^(Si),n2(S2),...n^(s^) 

COM 

ni(s^),n^(S2),...n^(sJ 

NAM 

EXAM 

BSS 

AA(30) 

DAT 

CAT (40) ,RAN(20) 

COM 

CCC(40) ,AB(10) 


The BSS will reserve 30 locations within the program while the DAT will reserve a total 
of 60 core locations, reserved outside of the program area, hi fact, this data area will 
immediately precede the main program area in core. The common area, 50 words in 
this example, is reserved at the high end of core where the loader resides at load time. 
This common area cannot be preset with data and can only be used at run time, when the 
loader is no longer needed. 
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ffigh 

Core 


013F 

0100 

OOFF 

0000 


Loader 


Loader Symbol Tables 


More Programs 

4 


Program 


Data 

Executive Monitor 
Resident 


Interrupt 

Area 


C ommunication 
Area 


50 Words 

Common Counter 


^ Program Counter 

60 Words 

♦Data Counter 
1 


Figure 13. Data, Program and Common Counters. 

Figure 13 illustrates the three coxmters: data, program and common counter. There 
are three types of relocation possible when loading programs, each type using its 
appropriate counter. References to addresses will be relocated using the data counter if 
the address is in the data area, the program coimter if the address is in the main program 
area and the common counter if the address is in the common area. 
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Example: 


NAM 

EXAMP 

DAT 

AA(IO) 

COM 

BB(IO) 

BSS 

CC(IO) 

LDA+ 

AA+3 

STA+ 

BB+7 

STA+ 

CC+4 


The listing for the above looks like: 


001. 



NAM 

EXAMP 

002. 


OOOOD 

DAT 

AA(IO) 

003. 


OOOOC 

COM 

BB(IO) 

004. 

POOOO 

OOOA 

BSS 

CC(IO) 

005. 

POOOA 

C400 

LDA+ 

AA+3 


POOOB 

0003D 



006. 

POOOC 

6400 

STA+ 

BB+7 


POOOD 

0007C 



007. 

POOOE 

6400 

STA+ 

CC+4 


POOOF 

0004P 




The first column is the line number. The second column is the core location in hex. 
The P preceding it indicates that the value of the program counter will be added to the 
number at load time, yielding the actual core location. 

Hex word followed by relocation symbol: P for program counter, D for data counter, and 
C for common coimter. 

Although there is only one common area and one data area assigned per core load, refer- 
ences to data in these areas can be made by all programs in core. The relative position 
with respect to the data or common counter for the data desired must be known by each 
program but the same names need not be used by different programs to reference the 
same data. 

Example: Program 1 is the first program loaded. It must declare the largest data or 

common area. 


NAM PROGl 

DAT AX(IOO) , BX(50) , CX(IOO) 
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When the program is loaded, a data area of 250 locations is assigned and the data counter ( 
is set at the beginning of this area. 

Suppose PROG6, which is the sixth program loaded, is interested only in the data which 
PROGl knows as the 26th to 30th locations in BX. 


NAM 

PROG6 

DAT 

DUMMY(125), MINE(5) 

LDA 

MINE 


DUMMY is not used by program 6. It only allows a skip past the AX and first 25 locations 
of BX corresponding to program 1. Reference to MINE in program 6 will yield the 
same data as reference to BX+25 in program 1. 

6.14 ORG, ORG* 

Presetting the data area is accomplished by the use of the ORG pseudo op. Its form is: 

ORG a 


This pseudo op changes the value of the assembler’s coxmter to agree with a. All in- 
structions or data following the ORG instruction are assembled into consecutive locations 
until either another ORG instruction is encoimtered or an ORG* is encountered. When 
an ORG* is encountered, the assembler’s program coxmter is set to the value that it 
would have been if the very first ORG instruction had not occurred. The address ex- 
pression (a) may be either positive program relocatable, positive data relocatable or 
absolute. Notice common relocatable address expressions are not allowed since the 
common area cannot be preset. 


Example: 


NAM 

EXAMP 

DAT 

LDA 

AX(20) , BX(40) 

ORG 

AX+10 

ORG 

AX 

BZS 

10 

ORG* 

' 

LDA 

- 


Assume P. C.=P0030 
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In this example the program counter starts off at 0000 and proceeds in sequence until 
the first ORG instruction is assembled. Since the address expression refers to the data 
area, the assembler’s program counter will now be at DOOOA, indicating that the code 
beneath this first ORG pseudo instruction will be inserted beginning in the 10th data area 
location. When the second ORG instruction is encoimtered, the code under it (BZSIO) is 
assembled into the beginning of the data area. When the ORG* instruction is encountered, 
the program counter is set to P0031; this is the next location following the last location 
assembled before the first ORG instruction. Any symbols used in the address expression 
of the ORG pseudo op must have been previously defined in the program. 



The following example can be used to illustrate presetting values in A and B in the DATA 


block: 

AE OOOOD 


DAT 

A(5) ,B(2) 

XE OOOOC 


COM 

X 

CE 0007D 


DAT 

C(50) 

OOOOP 

START 

0 

0 

OOOIP 


LDA- 

$FF 

0002P 


STA+ 

X 

OOOOD 


ORG 

NUM 

A 

0004P 


ORG* 

RAO- 

A B 

$FF 


6.15 IFA, EIF 


The macro assembler contains a conditional assembly instruction. With the pseudo op 
IFA, it is possible to specify portions of a program to be either assembled or excluded 
during assembly time. Its format is: 


s 


IFA 




(This pseudo op can be used within a macro skeleton. ) e may be an expression and c 
specifies one of four conditions: 


EQ 

®1“®2 

NE 

®1^®2 

GT 

ei>e2 

LT 

ei<e2 


The termination of the coding encompassed within the range of an IFA pseudo op is 
accomplished with the pseudo op EIF. Since nesting is allowed, a match between an IFA 
and EIF pseudo op range is made by correspondence between the first two characters of 
the symbols in the location field of the IFA and the address field of an EIF. 
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Example: 


TOTS 


NAM 

EXAMP 

EQU 

AB(IO) ,AC(20) ,AD(30) 

IFA 

AB+AC,EQ,AD 

LDA 

TAG 

STA 

TAGl 

EIF 

TOTS 


The LDA TAG and the STA TAGl instructions will be assembled in this example since 
equality exists. Changing the EQU card, however, or changing the condition from EQ to 
NE would have excluded these two lines of code from the assembly. 

Problem: 

VALUE PROBLEM (COMMON) 

Starting in the 11th location of COMMON are 10 words. Bits 13-8 of each of the 10 words 
are to be compared with bits 5-0 of a location called VALUE which is external to this 
program. Do not destroy the original contents of VALUE. Count how many complete 
matches are found in the bit strings compared and store the answer in the 7th word of the 
data block. For example, if bits 5-0 of VALUE contain 101100 and bits 13-8 of 
contain 101100, one match has been found. Any other bit configuration would be a no- 
match. Write a complete program to solve this problem. 



6.16 MAC, EMC 

The macro assembler gets its name from the macro capability incorporated therein. An 
often used set of instructions may be grouped together to form a macro. Macros then 
need be defined once and thereafter the whole macro structure will be incorporated in 
line in the assembly generated coding whenever the macro name is called. Each macro 
has a name which is first defined by the use of the MAC pseudo op and thereafter the 
name can be placed in the opcode field as if it were an instruction or pseudo instruction 
and the assembler will substitute, starting at that location, the whole structure that was 
previously defined by that name. The macro must first be defined. The form is: 


Pj.Pg.- 


p. 


n 


s 


MAC 



6. 16 




s is the name of the macro. The p's are symbols of one or two characters that will de- 
fine variables within the macro structure. Parameters are enclosed in apostrophes as 
shown within the macro. The keypunch code for apostrophe is 8-5. The macro stmcture 
itself is defined to be finished when the EMC pseudo op appears in the opcode field. EMC 
is always the last instruction in a macro definition. 


Example: 


HELP 


NAM 

EXAMP 

MAC 

XA,XB 

LDA 

'XA' 

STA 

'XA'+l 

ADD 

'XA'-l 

STA. 

'XB' 

EMC 



HELP is the name of the macro and XA and XB signify variables within the macro. All 
the code between the MAC and EMC is the macro structure. Anything in this structure 
can be made variable, hi this assembly only positions of the address field were varied. 
Macros canbe of any length and they can also be nested. A macro must be defined before 
it is called by name. Calling the macro in the above example would look like this: 



SAZ 

OVER-*-l 

HELP 

TAG, TAGl 

OVER 

— 

The macro is called by placing its name in the opcode field. The assembler will search 
the symbol directory for a macro with the name of HELP, and if foimd, the complete 
macro structure is placed in line at this point. When calling a macro, the variables must 
be specified. For this example TAG will be inserted for each XA reference and TAGl will 

be inserted for each XB reference, 
the following: 

Effectively, then, the assembler will place in line 

LDA 

TAG 

STA 

TAG+1 

ADD 

TAG-1 

STA 

TAGl 


A macro could be defined as "an instruction which 'stands for' a number of other instruc- 
tions. " 
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6.17 LOG 

Since the code for a macro is inserted in line wherever it is "called," if there are any 
symbols in the location field of the macro, it could be called only once, since the symbol 
would'be doubly defined if the macro were called again. This problem can be eliminated 
by defining the symbols local to the macro. 

Symbols that are local to the macro being defined are listed in the LOG pseudo op. This 
pseudo op immediately follows the MAC pseudo op and it allows use of one- or two- 
character symbols local to the macro so that the same symbols can also appear in the 


main program. Its form is: 



LOC 

Sj^, s^» • • • 

Example: 


NAM 

EXAMP 

TOPP 

MAC 

AD,AB 


LOC 

Gl, G2 


LDA 

’AD’ 

’AB» 

EOR 

=N$0171 

»G1» 

STA 

’AD’+l 

*G2’ 

JMP 

EMC 

’AD’+2 


Symbols passed as parameters may not be defined as local. 

6.18 IFC 

A conditional assembly pseudo op is available for use within the macro skeleton. It is 
the IFC pseudo op. It operates the same as the IFA covered previously; however, it has 
only two conditions, the NE and EQ. Its form is: 

s IFC a^, c, a^ 

Each a must be a string of from one to six characters, or a formal parameter specified 
in the MAC statement. The character strings should not contain commas, blanks or 
apos trophies. Two character strings are equal when they contain the same characters in 
the same position and are of the same length. Characters in excess of 6 are ignored. 
Termination of the range of the IFC is made when an EIF is encountered with the first 
two characters of the symbol in its address field matching the first two characters in the 
location field of the IFC. 
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EXAMP 
XA,XB,XC,XD 
=N$4000 
’XB’ 

’XC’EQ'XD’ 

’XB'+2 
’XB’ 

IT 

If parameter XC and XD are equal when this macro is called then the ADD and STA in- 
structions will be incorporated in line with the rest of the macro structure. If para- 
meters XC and XD are not equal when the macro is called, these instructions will 
not be inserted in line as part of this macro structure during assembly. 


Q, TAG, TEN, NINE 


=N$4000 
TAG 

Since TEN and NINE do not match character for character, the IFC condition is not met 
and the ADD followed by the STA instructions are not assembled. 

Problem: 

Write a macro for an INI instruction. Add a test routine to check it out. 

The INI macro s hould increase the I Register by any constant exactly the same way the 
INA increases the A Register or the INQ increases the Q Register, hi other words, no 
other registers should be destroyed when the macro is called. 

6.19 NLS, LST, SPC 

Three pseudo instructions are used for control of the listing. They are NLS, which pre- 
vents normal output list until a LST instruction is encountered or until the end of a 
program. Spacing paper on the printer is accomplished by the SPC pseudo op. The 
number of lines to space is specified as an absolute address expression in the address 
field. 


TOTAL 


O 


The generated code is: 


LDQ 

STA 


Example: 


TOTAL 


IT 


NAM 

MAC 

LD’XA’ 

STA 

IFC 

ADD 

STA 

EIF 

EMC 
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Example: 

NAM 

EXAMP 


r' 


LDA 

- 




SPC 

12 

12 lines are spaced 



NLS 


Listing is stopped 



LST 

— 

Listing is enabled 



6.20 EJT 

In addition to the NLS, LST, and SPC listing control pseudo ins tractions, the macro 
assembler also has an EJT pseudo op. This ins traction causes page ejection during 
printing of the list output. 

6.21 OPT 

Three standard options determine the type of output from the assembler. All three are 
automatically selected if no OPT statement is encountered before the first NAM. OPT 
is the only pseudo instruction that may precede the NAM pseudo op. No code is generated 
by this pseudo instruction. 

OPT must begin in card column 2. 

Normal execution of assembly produces list output on the standard list device, punch 
output on standard pxmch device and load and go output on the mass storage device. These 
are options L, P and X. Two other options are available. The M option will enable 
listing of macro skeletons and an A option will cause abandonment of the assembly and 
will return control to the operating system. To exercise these options or to eliminate 
any of the three standard options, the OPT pseudo instruction is used. When the OPT 
pseudo instruction is encountered by the assembler it will type OPTIONS on the tele- 
typewriter and allow the operator to manually reset the options desired. He can choose 
any or all of these five options. 

Option Meaning 

L List output on standard list unit 

P Punch binary output on standard punch unit 

X Load and go; executable output loaded on a mass storage 

device 

M List macro skeletons 

A Abandon assembly 
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Relocatable binary output is selected by the P option. The format is described in the 
1700 Operating System Reference Manual . 

If the X option is selected, relocatable binary output is placed on the mass storage unit 
for subsequent loading and execution as described in the 1700 Operating System Reference 
Manual. 

The L option results in assembly listing. 

6.22 MON 

After the last subprogram has been assembled, control can be returned to the operating 
system by use of the MON pseudo op. It may be used only after the END statement. 

MON must begin in card column 2, 

Example: 



cc 

2 

OPT 


MON 

cc 

2 


NAM 

PGM 

END 

n ^ 

NAM 

SUB 

END 

^ 


Name of main entry point in main 
program 


No name on subroutine end card 


6.23 EXERCISES ON PSEUDO OPS - UTILITY ASSEMBLER 
1. What are the errors in this program ? 


Location 

Opcode 

Address 

Comments 


NAM 

EXAMP 


LED 

EQU 

720 


TAG 

NUM 

-72,$FFFF,72 


TAGll 

BSS 

25 



EXT 

LAD, TAG 


START 

LDA+ 

TAG 



STA+ 

LAD 



END 

START 
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2. Why will the ORG LIST produce an error ? 

COM LIST(30) 

ORG LIST 


3. hi this example; 

COM LIST(30) 


LDA LIST 

this assembler will decode the LDA LIST as: 

C400 

OOOOC 


Why? 

4. What is the problem ? 


BSS 

LIST(IO) 

LDA 

LIST+3 

SAZ 

— 


6. 24 EXERCISES ON PSEUDO OPS - MACRO ASSEMBLER 
1. What code is produced: 


a) 

VFD 

N12/-17 , N5/$7F2 , N15/47 

b) 

VFD 

as/ a j as/ b 

c) 

DEC 

16D1B4 

d) 

ADC* 

*-l 
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2. What instructions are assembled: 



EQU 

AA(10),BB(20),CC(30) 

GOl 

IFA 

10, GT, BB-15 


LDA 

=N$1000 

T02 

IFA 

CC-AA, EQ,BB 


ADD 

=N$1000 

H03 

IFA 

40, NE, BB*2 


ADD 

=N$2000 


EIF 

HO 


EIF 

TO 


EIF 

GO 

3. If this macro 

definition; 


PRINT 

MAC 

XA,XB,XC 

TAG 

ALF 

Z,ERROR’XB’Z 


IFC 

»XA»,EQ,LU 

TAGl 

ALF 

Z, LOGICAL UNIT’XC 


EIF 



EMC 


is called by 

PRINT 

LU, 6, 8 


what assembly language is produced when this macro is called ? 
4, What discrepancy is in this program? 


FALL 

MAC 



LOC 

TE 

»TE» 

NUM 

$7FF3 


LDA 

’TE’ 


EMC 



FALL 



LDA 

TE 
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7.0 INTRODUCTION 


The 1700 is composed of a 1704 and various peripherals. The 1704 contains the regis- 
ters and the logic necessary for bringing data into the computer, performing operations 
upon the data and sending the data out of the computer for future reference and/or dis- 
play. 


INPUT ^ 

1 

CONTROL 1 ARITHMETIC 

1 
1 

OUTPUT^ 

■ W 

MEMORY 



1704 


The peripherals are composed of devices capable of sending and/or receiving data. 
Such devices are the teletype, paper tape reader and paper tape punch. Many other 
peripherals are available and discussed in Chapters 12 and 14. 

The peripherals and the 1704 cannot communicate directly; therefore, an interpreter 
is required. The interpreter is referred to as a controller. The program tells the con- 
troller the operation to be performed and the controller directs the peripheral in the 
performance of the operation. 

7. 1 UNBUFFERED l/O 


7. 1. 1 Use of Registers in l/O 


Communications among the 1704 and the peripherals is accomplished via one 
input/ output (l/O) channel attached to each controller. The I/O channel works in 
conjimction with the 1704' s A register and Q register. It is, consequently, called 
the A/Q channel. 











7. 1.1.1 


7. 1. 1. 1 Q Register 

The Q register designates the equipment to be referenced and directs the op- 
erations to be performed. The Q register will be in the following format when 
performing an l/O operation via the A/Q channel. 


15 


11 10 A\ 7 6 


0 


Q 


W 


E 


S 


D 


The W field , bits 15-11, will always be zero except when referencing a 1706; 
this will be discussed later. 

The E portion, bits 10-7, designates the equipment number being referenced. 
The equipment number will correspond directly with a hardware switch located on 
each controller. The number will vary from a hexadecimal 0 to a hexadecimal 

F. 

The S portion distinguishes among peripherals attached to the same controller. 
The bits composing the station code will vary with controllers. 

The D portion is the director bit or bits which designates the type of information 
being transferred: data, status or function. The number of bits used to com- 
pose the D portion also varies according to the controller being referenced. 

7. 1. 1. 2 A Register 

The A register sends and receives all communications between the 1704 and 
the peripherals; that is, the data, functions, or status. 

7. 1. 2 Functions, Status, and Data 

The 1704 is capable of sending or receiving data, sending a function, or receiving 
status. The D portion of Q and the I/O instruction executed denote which of 
the three operations is to be performed. All input/ output operations via the A/Q 
channel are performed with two instructions. 

INP 

OUT 

The INP instruction brings information into the A register: data or status. 
The OUT instruction sends information from the A register: data or function. 
Bit 0 of Q is usually the D portion, designating the type of information being 
transferred. (Note: the exceptions are discussed in Chapter 14. ) When bit 0 
of Q is a 0, the transfer of data is designated. The direction of the data flow is 
indicated by the l/O instruction. The INP briugs data into A. The OUT sends 
data from A. When bit 0 of Q is a 1, the transfer of status or the transfer of a 
function is requested. INP requests status while an OUT sends a function. 
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INP 


D = 1 status 


OUT 



D = 0 data 
D = 1 function 


7. 1. 3 Summary, Unbuffered l/ O 

In review, all input/ output operations performed by the 1704 will take place via 
the A/Q channel. The Q register indicates the peripheral being referenced and 
the type of information being transferred. The information to be transferred will 
be brought into or sent from the A register, depending upon the instruction exe- 
cuted: INP or OUT. Three types of inf or mati on may be transferred: data, 
function, or status. 


7.1.4 Low- speed Package 

The grouping of the teletype, paper tape reader and paper tape punch is referred 
to as the low-speed package. The low-speed package is always equipment number 
1. The various peripherals attached are referenced specifically with the S por- 
tion of the Q register, bits 4-6. 


Peripheral 


"S"tation 


Teletypewriter 
Paper tape reader 
Paper tape punch 


1 

2 

4 


The format of Q for each of the low-speed peripherals is as follows : 


15 



11 

10 


7 

6 

5 

4 

3 

2 

1 

0 

0 

0 

0 

0 0 

0 

0 0 

1 

0 

0 

1 

0 

0 

0 

d1 





V 


/\ 


_j 










Equip. 

1 



Station 

1 









TELETYPEWRITER 

$0090/$0091 




















15 

14 

13 

12 11 

10 

9 8 

7 

6 

5 

4 

3 

2 

1 

0 

1 ^ 

0 

0 

0 0 

0 

0 0 

1 

0 

1 

0 

0 

0 

0 

d| 


Equip. Station 

1 2 


PAPER TAPE READER $00A0/$00A1 
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15 

14 

13 

12 

11 

10 

9 

8 

7 

6 

5 

4 

3 

2 

1 

0 

1 ^ 

0 

0 

0 

0 

0 

0 

0 

1 

1 

0 

0 

0 

0 

0 



Equip. Station 

1 4 


PAPER TAPE PUNCH $00C0/$00C1 

The programmer must load the Q register with the correct equipment, station 
and director setting prior to executing the desired l/O instruction. 

The coding necessary to reference each of the low-speed peripherals for data is 
as follows: 


LDQ 

=N$0090 

TTY FOR DATA 

NOP 



INP 

-1 

DATA IN A 

LDQ 

=N$0090 

TTY FOR DATA 

LDA 

DATA 

DATA IN A 

NOP 

OUT 

-1 

SEND DATA TO TTY 

LDQ 

=N$00A0 

PTR DATA 

NOP 

INP 

-1 

DATA IN A 

LDQ 

=N$00C0 

PTP DATA 

LDA 

DATA 

DATA IN A 

NOP 

OUT 

-1 

DATA TO PTP 


7. 1. 5 Reply or Reject 

Control will be returned to the program after the execution of an I/O instruction 
at one of three locations: P+1, P+A, P+l+A. Control will be returned to P+1 
when the controller accepts the command, NORMAL REPLY. Control will be 
returned to P+l+A when the controller rejects the command, EXTERNAL REJECT. 
If the controller fails to reply or reject within 6 microseconds, an INTERNAL 
REJECT is generated and control continues at P+A. The NOP instruction is 
inserted within the above coding to allow for an INTERNAL REJECT. 
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RESPONSE 

ADDRESS 

INSTRUCTION 

_A. 

INTERNAL REJECT 

^2000 

NOP 


EXTERNAL REJECT 

-►(P) 2001 

INP 

-1 

NORMAL REPLY 

► 2002 

Continue 


INTERNAL REJECT 

P+ A 

2001+(-l)=2000 


EXTERNAL REJECT 

P+1+ A 

2001+l+(-l)=2001 


NORMAL REPLY 

P+1 

2001+1=2002 



7. 1. 6 Functions 

I/O programming for the 1700 peripherals requires the programmer to connect 
with the desired peripheral by setting the Q register and issuing a function. 


LDQ 

=N$00A1 

LDA 

FUNC 

NOP 


OUT 

-1 


PTR FOR FUNG OR STATUS 
FUNCTION IN A 

SEND FUNCTION TO PTR 




A function is a command or a group of c ommands sent to the controller. The 
function sent will vary according to the eqmpment. The paper tape reader allows 
the programmer to clear the controller, clear interrupts , select interrupt 
on data and/or alarm, start motion and stop motion. Each function corres- 
ponds to a bit in the A register. The function is requested if a 1 appears in 
the corresponding bit. 


A 


15 


76543210 


1 I 1 I 1 


STOPMOTIOr^ I 
START MOTION 
INTERRUPT ON ALARM 

DATA INTERRUPT REQUEST 

CLR INTERRUPTS 

CLR CONTROLLER 


The above functions may be sent together, with the exception of the clear con- 
troller and clear interrupt; these must be sent separately. 

7. 1. 6. 1 Paper Tape Reader Example 

The programmer may clear the controller to clear all logic and interrupts pre- 
viously selected by loading Q with $00A1, by setting bit 0 of the A register and by 
issuing an OUT instruction. 
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LDQ 

ENA 

OUT 


=N$00A1 

1 

-1 


PTR FUNG OR STATUS 
CLR CONTROLLER 
FUNG TO PTR 


The programmer may then start the motor on the paper tape reader. The start 
motor command causes the reader to begin moving paper tape and start reading. 


LDQ 

=N$00A1 

ENA 

$20 

OUT 

-1 


PTR FUNG OR STATUS 
START MOTION 
FUNG TO PTR 


The next step is to bring the data into the A register by setting the director bit 
of Q to 0 and issuing an INP instruction. 

LDQ =N$00A0 PTR FOR DATA 

NOP 

INP -1 DATA INTO A 

The program will continue to loop on the INP instruction until data has been read 
into the holding register of the paper tape reader. Once data is available it will 
be brought into the lower 8 bits of the A register. Note: the number of bits 
composing a data word will vary among the peripherals. The first frame will be 
in A and may be shifted to the upper 8 bits. Input will then be requested again 
for the lower 8 bits. 

ALS 8 FIRST FRAME UPPER 8 BITS A 

NOP 

INP -1 NEXT FRAME BROUGHT TO A 

The entire 16-bit word is now in the A register and should be stored in the 
buffer area. Once the word is stored the program continues to bring data into 
the A register. A check should be made to determine when all requested words 
have been read from the reader. 



7. 1.6.1 



NAM 

PTR 

START 

LDQ 

=N$00A1 


ENA 

1 


OUT 

-1 


ENA 

$20 


OUT 

-1 


INQ 

NOP 

-1 

DATA 

INP 

-1 


ALS 

NOP 

8 


INP 

-1 


STA* 

BUF 


LDA 

WDCK 


SAP 

COMP 


RAO* 

WDCK 


JMP* 

DATA 

COMP 

SLS 

0 

WDCK 

NUM 

FFFO 


END 

START 


PTR FOR FUNC/STATUS 
CLR CONTROLLER 
FUNC TO PTR 
START MOTOR 
FUNC TO PTR 
PTR FOR DATA 

FRAME IN A 
DATA UPPER 8 BITS 

16-BIT WORD IN A 
SAVE IN MEMORY 
WORD CHECK IN A 
WHEN POSITIVE COMPLETE 

CONTINUE READING 
STOP WHEN COMPLETE 
CHECK FOR 16 WORDS 


The programmer may check for leader on the paper tape as has been done in the 
example on the next page. 
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1721 PTR - AUG ’68 
USDA 

*Clear controller from console; cannot start motion and clear controller in same 
function. 


01. 



NAM 

BOOTSTRAP 


o 

to 

• 



ENT 

START 


03. POOOO 
POOOl 

EOOO 

OOAl 

START 

LDQ 

=N$A1 

PTR DIR FUNG 

04. P0002 

0A20 


ENA 

$20 

START MOTION* 

05. P0003 

03FE 


OUT 

-1 


06. P0004 

ODFE 


INQ 

-1 

SET TO READ 

07. P0005 

OBOO 


NOP 



08. P0006 

02FE 

LOADl 

INP 

-1 

INPUT LEADER 

09. P0007 

0113 


SAN 

3 


10. P0008 

18FD 


JMP* 

LOADl 


11. P0009 

OBOO 


NOP 



12. POOOA 

02FE 

LOAD2 

INP 

-1 

INPUT FRAME 

13. POOOB 

0FC8 


ALS 

8 

SHIFT TO PACK 

14. POOOC 

OBOO 


NOP 



15. POOOD 

02FE 


INP 

-1 

INPUT NEXT FRAME 

16. POOOE 

6C04 


STA* 

(ADDRES) 

STORE WORD 

17. POOOF 

0103 


SAZ 

EXIT-*-l 

EXIT ON ZERO WORD 

18. POOlO 

D802 


RAO* 

ADDRES 

UPDATE ADDRESS 

19. POOH 

18F8 


JMP* 

LOAD2 

GO GET NEXT WORD 

20. P0012 

0014 P 

ADDRES 

ADC 

*+2 

LOAD AT P0014 

21. P0013 

0000 

EXIT 

NUM 

$0 

ZERO FOR SLS 

22. 



END 

START 


OOFF 

START 

OOOOP 

LOADl 

0006P LOAD2 

OOOAP ADDRES 0012P 


EXIT 0013P 


^OOTST 

■ti 


Where 

/ BOOTSTRAP 
1725 loaded 


Set Stop switch up and program will stop 
after reading paper tape. Run and loaded 
PGM will execute. 
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7.1.7 Status 

The paper tape reader has been programmed without the use of interrupts for 
each of the above examples. Status may be taken on the paper tape reader at any 
time to monitor the progress of the operation or to assure the program that the 
operation was c omple ted correctly. Status is taken by setting the Q register 
and issuing an INP instruction. 

LDQ =N$00A1 PTR FUNC/STATUS 

NOP 

INP -1 STATUS TO A 

The status is now in the A register. The status conditions exist if a 1 is present 
in the corresponding bit position. 


15 11 10 9876543210 



POWER ON^ f ^ 

PAPER MOTION FAILURE 

EXISTENCE CODE 

PROTECTEI 

LOST 

^ i 
) 

DAT^ 

A 

1 i 

LARIV 

I 

DATA 

L i 

1 i 



INTERRUPT I 
BUSY 

READY 

Ready (bit 0); Power is on and paper tape has been loaded into the reader. The 
preparations have been made known to the logic by pressing the READY switch on 
the paper tape reader console. The reader becomes not ready if a paper motion 
failure occurs or if the power is turned off. 

Busy (bit 1); The paper tape reader is busy if a start motion command has been 
issued and no stop motion command has followed. Motion stops on a stop motion 
command, a paper motion failure, or if the power is turned off. 

Interrupt (bit 2); An interrupt condition exists. Other status bits must be ex- 
amined to determine the condition causing this interrupt. 

Data (bit 3); The data hold register in the paper tape reader contains an 8 -bit 
frame of data which is ready for transfer to the computer. Start motion must be 
set to receive this status. The status drops when the data hold register is 
emptied by transfer to the computer. 
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Alarm (bit 5): At least one of the following conditions exists in the paper tape 
reader: (1) paper motion failure (bit A9), (2) lost data (bit 6), or (3) power off 

(bit AlO is 0). 

Lost data (bit 6): When in interrupt on data mode, paper motion continues after 
the data hold register is full. If the data is not transferred to the computer 
before the next frame appears, a lost data status occurs to show a frame has 
been passed. The time between frames is 2.857 milliseconds. The status drops 
when a clear controller command is sent. Lost data stops tape motion. 

Protected (bit 7): The PROGRAM PROTECT switch is on. This switch on the 
paper tape reader works in conjunction with the PROGRAM PROTECT switch on 
the computer. If the switch on the computer is off and the PROGRAM PROTECT 
switch of the peripheral device is on, no action is taken but the status bit is set to 
indicate the switch is on. If the switch on the computer is set, all rules of pro- 
gram protection apply. The paper tape reader in this condition only accepts 
protected instructions. 

Existence code (bit 8): The paper tape reader is attached. If the bit is a 1, 
the reader is missing from the particular computer system. 

Paper motion failure (bit 9): No change in the feed hole circuit has occurred for 
40 milliseconds while trying to read. The paper motion failure causes the reader 
to become not ready; it can only be made ready by pushing the READY switch or 
by a clear controller command. It is considered an illegal operation to send 
any other function code or a read command to the reader imtil the READY switch 
has been pressed or a clear controller has been issued. 

Power on (bit 10): Power to the reader is on. If this bit is a 0, power is off. 


7. 1. 8 Interrupts 

The paper tape reader may be programmed with interrupts by simply selecting 
the desired interrupts and exiting to the operating system or continuing execution 
of instructions within the program. When a selected interrupt is generated, con- 
trol will be returned to the program. 


LDQ 

=N$00A1 

PTR FUNC/STATUS 

ENA 

1 

CLR CONTROLLER 

OUT 

-1 

FUNC TO PTR 

ENA 

$34 

START MOTOR, ALARM, DATA 

OUT 

Exit 

-1 

FUNC TO A 


When the interrupt returns control to the program, status must be taken to deter- 
mine which of the two interrupts was generated, data or alarm. If the data 
interrupt was generated, the programmer brings the data into A and saves it. 
Once the data is saved, a check should be made to determine if all data has been 
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transferred. If the operation was not complete, the programmer should re- 
select interrupts and exit, waiting for the next interrupt. 


7. 2 BUFFERED l/O EXAMPLE 

The A/Q channel prohibits the execution of other instructions while data is being trans- 
ferred. The reason is obvious: the Q register and A register, which are used for l/O, 
are also the arithmetic registers. A direct storage access (DSA) channel may be con- 
nected to the 1704. The DSA transfers data directly to memory, bypassing the A and 
Q registers. Therefore, a program may be executing while data is being transferred. 
The direct storage of data is referred to as BUFFERING. The A/Q channel is used to 
send functions and receive status, but the data is transferred via the DSA. The disk is 
an example of a buffered device. 



O 
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SIDE VIEW: 

850 DISK PACK 
(6 DISKS) 


J DISK SURFACE 0 

DISK SURFACE 1 


i DISK SURFACE 9 


TOP VIEW: 
DISK SURFACE 



ROTATION 

853 contains 100 cylinders; 854 contains 200 cylinders. 

Figure 14. Side and Top Views of 850 Disk Pack 
7. 2. 1 Disk Functions 

The program selects the disk by setting the Q register with the equipment 
number and the desired director bits. Throughout this discussion the disk shall 
be considered equipment number 8. 
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15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 



EQUIP 8 


The setting of the director bits will define the operation and the information to be 
sent from or received in the A register. 



Value Set in Q 



(Bits 02-00) 

Output from A 

Input to A 

001 

Director function 

Director status 

010 

Load address 

Address register status 

Oil 

Write 


100 

Read 


101 

Compare 


110 

Checkword check 


111 

Write address 
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7. 2. 1.1 


7. 2. 1. 1 Director Function 
D = 001 , OUT 


LDQ 

=N$0401 

DISK FOR FUNG 

LDA* 

FUNG 

FUNG IN A 

NOP 

OUT 

-1 

FUNG TO GONTROLLER 



CLEAR INTERRUPT 


The clear interrupt function will clear all selected interrupts, allowing the 
programmer to select the interrupts he desires. Three interrupts may be 
selected: next ready and not busy status, end of operation, and alarm. The next 
ready and not busy interrupt occurs when the 1738 becomes not busy but still 
holds its ready status. 

The end of operation interrupt allows the controller to inform the 1700 when 
it has completed an operation such as a data transfer. The alarm interrupt 
will notify the 1700 that an alarm condition has arisen. There are eight possible 
alarm conditions: not ready, checkword error, lost data, seek error, address 
error, defective track, storage parity error, and protect fault. 

The release function allows an unprotected program to use the disk even though 
the protect switch on the disk is still set. A protected program must issue the 
release function. The next time a protected program accesses the disk, the disk 
will become protected and must again be released before it will become accessible 
to an unprotected program. 

The unit select and unit select code will always be zero unles s two disks are 
connected to the controller. Bit 8 is the imit select bit. It informs the con- 
troller that the program will select unit 0 or unit 1. Bit 9 indicates which unit 
bit 8 wishes to select. If 9 bit is a 0, unit 0 is selected; if it is a 1, unit lis 
selected. The controller ignores bit 9 unless bit 8 is set. 
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7. 2. 1, 2 Load Address Function 
D = 010 , OUT 

Once the functions have been sent to the controller, the program notifies the con- 
troller of the beginning address on the disk to be used by the program. The Q 
register is loaded with the D portion set to 010 and the disk address (sector 
record address) is placed in the A register (Figure 14), 


LDQ 

=N$0402 

LDA 

=XDISKAD 

NOP 


OUT 

-1 


DISK FOR DISK ADDR 
ADDR IN A 

ADDR TO THE DISK 


The controller will position the Read/Write heads on the requested address. The 
heads will be moved directly to the address forward or backward, depending on the 
current location of the Read/Write heads. The address held in the A register 
will be in the following format. 


A 


15 


8 7 


4 3 


0 


CYLINDER 


HEAD 


SECTOR 


The disk has been functioned and given the desired disk address. The next step 
will be to initiate one of three operations. 


WRITE D = Oil 

READ D = 100 

COMPARE D = 101 


7, 2. 1. 3 Write Function 


D = Oil , OUT 

The write function code requests the controller to prepare to read data from 
memory and write it on the disk. 


LDQ 

LDA 

OUT 


=N$0403 DISK TO WRITE 

=XMEMADR MEMORY ADDR IN A 
-1 WRITE OPERATION INITIATED 


The controller expects to find the first word address minus 1 (FWA-1) of the buf- 
fer area in the A register when the write function is received. The controller 
goes into memory via the DSA to the FWA-1, at which location the controller ex- 
tracts the last word address plus 1 (LWA+1), The controller keeps the LWA+1 
and updates the FWA-1 xmtil the two are equal; at this point the write operation 
is complete. The controller updates the address each time a 16-bit data word is 
transferred from memory. 


7-15 




7. 2. 1.3 


DATA BUFFER FOR DISK 


FWA-^ 


LWA-^ 



FWA - 1 MUST CONTAIN LWA + 1 OF BUFFER 


Prior to issuing the write operation, the interrupts must be selected, the sector 
record address must be sent to the controller and the LWA+1 of the buffer area 
must be at the FWA-1. 


LDQ 

=N$0401 

LDA* 

FUNC 

NOP 


OUT 

-1 

LDQ 

=N$0402 

LDA 

=XDISKAD 

NOP 


OUT 

-1 

LDA 

=XLWAP1 

STA 

FWAMI 

LDQ 

=N$0403 

LDA 

=XFWAM1 

NOP 


OUT 

-1 


DISK FOR FUNC 
SELECTED INT IN A 

INT SELECTED 
DISK FOR DISK ADDR 
ADDR IN A 

HEADS POSITIONED 
LWA+1 IN A 
LWA+1 AT FWA-1 
DISK TO WRITE 
FWA-1 IN A 

OPERATION INITIATED 


The 1704 continues executing instructions while the disk transfers data. When 
the data has all been transferred or an alarm condition has arisen, the 1704 will 
be notified. 
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7. 2. 1. 4 Read Function 
D = 100 ; OUT 

The read function code follows the same programming procedure as the write 
function, the differences being the D setting of Q and the fact that the disk reads 
data into memory rather than writing data on the disk. 

7. 2. 1. 5 Compare Function 
D = 101 ; OUT 

The compare function code follows the same programming procedure as the 
read and write fimction codes. The compare function causes the controller 
to read data from the computer’s memory and compare it with the data stored on 
the disk. If at any time during the compare, one word does not compare, the no 
compare status bit will be set. This function provides an extra check on the 
validity of the data transferred. 

The checkword check (D=110) and write address (D=lll) functions are used by the 
customer engineers. 

7. 2. 2 Disk Status ^ ^ 


7. 2. 2. 1 Director Status 
D = 001 , INP 

Status may be taken to monitor the operation of the disk. Once the disk gen- 
erates an interrupt, status must be taken to determine which interrupt was gen- 
erated. This is accomplished by loading the Q register with the D portion set 
to 001 and by issuing an INP instruction. 


LDQ 

NOP 

=N$0401 

DISK FOR STATUS 

INP 

-1 

STATUS IN A 


15 14 


13 12 11 10 




PRODUCT FAULT 
STORAGE PARITY ERROR 

DEFECTIVE TRACK 

ADDRESS ERROR 

SEEK ERROR 

LOST DATA 
CHECKWORD ERROR 

PROTECTED 

NO COMPARE 


A A 


READY 
BUSY 

INTERRUPT 
ON CYLINDER 
END OF OPERATION 
ALARM 
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The ready status indicates that the unit is available. The busy bit indicates 
that the controller and/ or the drive unit is presently involved in the performance 
of an operation. This bit is set with the acceptance of a load address, write, 
read, compare, checkword check, or write address function. At the completion 
of the function which set the busy status, the status will be cleared and the disk 
will become not busy. Once the disk is not busy, a new fimction may be issued. 



The interrupt bit acknowledges that an interrupt has occurred. Further ex- 
amination of A will determine which of the three selected interrupts was gen- 
erated: bit 4 (EOF) and bit 5 (ALARM). 

If neither bit 4 nor bit 5 is set, the programmer should check bits 0 and 1 for 
ready and not busy. If the alarm bit is set, the programmer must determine 
which of the eight alarm conditions caused the interrupt. 

The on cylinder status bit 3 is set when the Read/Write heads have reached the 
sector record address initially sent to the controller via the A/Q channel. 


7. 2. 2. 2 Address Register Status 


D = 010 ; INF 

The programmer may request the disk to return the current position of the Read/ 
Write heads at any time by selecting the disk as above but issuing an INF instruc- 
tion. 


LDQ 

NOF 

=N$0402 

DISK FOR DISK ADDR 

INF 

-1 

CURRENT ADDR IN A 



The address will be in the same format used to send the address to the controller. 


7.2.3 Summary, Buffered I/O 

The DSA provides the 1704 with a means of storing data directly in memory; this 
permits the execution of instructions while transferring data. The program sends 
the function word, the sector record address, and stores the LWA+1 of the buffer 
area at the FWA-1 prior to initiating an operation. The operation is indicated by 
the D portion of Q, with the A register containing the FWA-1 of the buffer area. 
The controller interrupts the 1704 when a selected interrupt condition arises. 
The program takes status to determine which of the selected interrupts was gen- 
erated. 
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8.1 


8.1 OPERATING SYSTEMS 

The 1700 computer system has two commonly used operating systems: the utility system 
and the mass storage operating system (MSOS). MSOS is a disk or drum oriented sys- 
tem and allocates the resources of the computer according to a priority system. The 
utility system is a much smaller system. It provides for assembly, loading, and execu- 
tion of programs in a batch mode. 

8.1.1 Utility 

The 1700 utility system provides the 1700 computer with a means of loading and 
executing programs in configurations smaller than the minimum, required for the 
1700 operating system. The utility system requires 8K of core but no disk or 
drum. l/O is by way of the paper tape reader and paper tape punch, and listing 
and operator control is through the teletype. * Execution of jobs through the 
utility system can make use of the standard drivers provided by utility. The 
standard drivers provided are for the teletype, paper tape input, and paper tape 
output. It is possible, then, to operate these devices in one’s own program by 
simply using a standard calling sequence. 

8.1.2 MSOS 

Under MSOS core is divided into two areas: for egr ound and background. The 
foregroimd is for system and process programs. System programs are those 
programs that make up the operating system, such as the job processor and 
drivers. Process programs are those application programs that are most im- 
portant to the particular installation. For example, if the system is controlling a 
chemical plant operation, those programs monitoring the chemical process are 
the process programs. The process programs and system programs usually 
have the highest priority and have access to the resources of the computer first. 
Foregroimd is protected; this means the on-line process programs cannot be de- 
stroyed by programs in the background and they cannot be inadvertently brought 
into execution by background programs. However, background programs may 
make use of protected routines such as l/O drivers. 

Background programs are run in a batch mode (serially) and run at the lowest 
priorities in the system. Programs in the background are called jobs. Assem- 
bling, compiling, and loading are examples of such jobs, 

8. 2 REQUEST PROCESSING 

Three basic functions of the operating system are to: (1) allocate core space to those 
programs that want to use it, (2) communicate with the outside world, i. e. , supervise 
I/O operations, and (3) allocate CPU time between the various programs. When a pro- 
gram wants one of these functions done, a request is made to the operating system. 


*There are other options available. 
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A request takes the form of a transfer of control to the module of the operating system 
that processes requests (the request entry processor, entry point name MONI) followed 
by words containing the necessary parameters for the particular request. 

The entry address for MONI is always located in core location F4 so every request is 
initiated by an indirect return jump through F4. The return jump will provide the link- 
age necessary. The parameter string length is different for different requests: 

RTJ ($F4) TO MONI 
Request code 
and other parameters 

hi the first parameter word, bit positions 9 through 14 will be the request code. This is 
for all requests. 

MONI saves the registers of the requesting program in a special core area called volatile 
storage and gives control to a request processor denoted by the request code in the para- 
meter list. This processor must return control to the request exit processor which re- 
turns control to the requesting program. 

The 1700 operating system provides the user with up to 30 monitor requests; 20 are 
reserved for the operating system. However, they may be replaced by user-written pro- 
cessors when the system is initiated. The other 10 requests maybe added at initialization 
by including in the resident load the necessary programs with the required entry points. 
The number of possible request processors can be extended from 30 to 63 by reassembly. 

Each request processor is a separate submodule and has a coded entry point with one of 
the following names: 


54F4 

xxxx 

xxxx 



reserved for system use 


available to users 


The numerical part of each name is the request code. It corresponds to the value of an 
index to a table of request processor addresses contained in MONI. 

MONI has these entry points as externals providing linkage with each appropriate request 
processor. 

Since the numeric part of the entry point name for each request processor must corres- 
pond to its request code, a request code of 5 will provide entry through MONI to module 
T5. 
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User 

Requests 


Request 



Entry 

Processor 



► 



Request Submodules 


Users can assemble an added request processor, assign a request code to it, and affix 
the entry point with T followed by the number for the request code and incorporate it as 
part of the system, 

8. 2. 1 Summary of Request Processing 

Note that all requests begin with the return jump toMONIand that MONI determines which 
type of request it is by examining the request code in the first word of the parameter 
string. Each type of request has a request processor to which MONI gives control, 
depending on the request code. When control is given to the request processor, several 
functions take place before control is returned to the requesting program. 

It is important for the programmer to understand that a request only initiates action de- 
sired of the operating system. It does not do anything, hi most cases, a request causes 
the desired action only to be put on a queue; control is returned immediately to the 
requestor at the next instruction beneath the parameter string. 

For example, it is desired to write a message on logical unit 4: 

REQ RTJ- ($F4) 

(Parameters for a 
write request on 
logical imit 4) 

RET I 

Control is passed to MONI. MONI passes control to the Read/Write request processor 
which puts the request on a queue of other messages waiting to be printed on logical unit 
4, Control then passes to the request exit routine which returns control to the requestor 
at RET. The message has not yet been written but it will be done in due time. 
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8.2.1 



Figure 15. Flow of Requests 


8.3 REQUESTS 


The following requests are included in the standard operating system: 


READ* 


WRITE* 

FREAD* 

FWRITE* 

SCHEDULE 

TIMER 






Available to both foreground and 
background programs. 


EXIT* 

CORE 

LOADER 

GTFILE 

STATUS* 


Available only to background programs. 

Request processor modules for these 
requests must have the same residency 
as the job processor. 


SPACE 

RELEASE 


> 


Available only to foreground programs. 


INDER is an indirect version of any of the listed requests. 
The job processor can make any request. 


*These requests are included in the utility system. 
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System macro calls are available to generate the code for the requests under the macro 
assembler, which runs under MSOS. Codes for the requests imder the utility system 
must be coded by the programmer. 

In this chapter those requests that are available to background programs will be dis- 
cussed. Those requests available only to foreground programs will be discussed in 
Chapter 11. 

Any of the allowable requests for backgroimd programs will be accepted by the operating 
system and put on the desired queue. They will not be rejected. 
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RC NUM 


EXIT 


5 

OAOO 

FWRITE 

5 , c, s, n, m, rp, cp, a, x* 

6 

ocxx. 

FREAD 

C , c, s, n, m, rp, cp, a, x* 

4 

08XX 

WRITE 

, c, s, n, m, rp, cp, a, x* 

2 

04XX 

READ 

, c, s, n, m, rp, cp, a, x* 

1 

02XX 

SCHDLE 

c,p,x 

9 

12XX 

TIMER 

c, p,x, Q, u Parameter in Q 

8 

lOXX 

CORE 

^ Parameters in A and Q 

11 

1600 

LOADER 

Parameters in A and Q 

7 

OEOO 

GTFILE 

c, f, s, wl, w2,x, rp, cp 

13 

lAOl 

STATUS 

C, ap, a,x 

3 

0600 

INDIR 

(ap) 

- 

- 


General Definitions 

2 logical unit 
c completion address 
s starting address of data block 
n number of words 
m mode 

rp request priority 
cp completion priority 
ap address of parameter list 
p priority 
u units 
f index 

X mode of addressing indicator for c,s,n,f, and ap in STATUS 
a mode of addressing indicator for logical unit 


Figure 16. Macro Calls for Requests Available to Backgroimd Programs 


*For mass storage devices the programmer sets up two words following the request to contain 
the mass storage address. 
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8. 3« 1 EXIT Request - Request Code 5 

The EXIT request is available only to background programs. 

When control is to be given back to the job processor, the EXIT request is used. 
This may be when the program has reached a point where it has completely 
finished its goal and wants to terminate itself or when it wants to give up control 
while waiting for an I/O operation to take place. 

The EXIT assembles into two words in the following manner: 


000101 


000000000 


RC = 5 



54F4 



OAOO 


macro call: 

EXIT 


coded call: 

RTJ- 

($F4) 


NUM 

$0A00 


Most of the examples in this chapter have at least one EXIT request; check them 
for its use and assembly. 

If this request were executed in a completion routine, normal processing of a job 
would resume at the location where it was interrupted. If this request was not 
executed in a completion routine, the job is considered complete. 

The EXIT request simply causes a jump to the dispatcher which could be accom- 
plished by: 

EQU ADISP($EA) 

JMP- (ADISP) 
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8.3.1 


This would be abetter way to code exits since it saves time and since protected 
programs cannot make EXIT requests. 

In the backgroxmd, the jump to the dispatcher can be used only under MSOS 2. 0; 
under 1. 0 it can only be used in the foregroimd. 

8. 3. 2 Read/Write Requests - Request Code 1, 2, 4, 6 

For peripheral equipment that more than one program may use, a standard driver 
for each is written and incorporated into the operating system. The programmer 
makes use of the driver when he makes a Read/Write request to the operating 
system. Read/ Write requests are available to both foregroimd and background 
programs. 

When the programmer wants to communicate with a peripheral device, he makes 
a READ, WRITE, FREAD, or FWRITE request. Reads are used when informa- 
tion is to be brought into core and writes when information is to be transferred 
from core to the device. 

When a Read/Write request is made, the transfer of data is only initiated. If the 
driver is busy working on another request, the new request is placed in a list of 
requests waiting to use the device. The position of the request on the queue will 
depend on the request priority. The request itself is not placed on a stack but is 
simply threaded. When the device is free and the transfer begins, there will be a 
period of time lapse before the complete transfer has taken place. During this 
time, control is given back to the requesting program so that it may execute any 
portion of the program that is not dependent upon the data. Therefore, when con- 
trol returns to the instruction immediately following the parameter list, the pro- 
grammer cannot assume that the transfer of data has been completed or, for that 
matter, even begun. 

The programmer specifies a completion address in the request. Control will be 
given to this address when the request has been completed, according to the com- 
pletion priority in the request. 

This completion address is where the device driver will schedule reentry after the 
particular request has been completed. This scheduling of the completion address 
is done by the driver using the SCHDLE schedule request; this completion address 
is scheduled by priority. There are, then, parameters in the Read/Write requests 
to signify the priority of the request itself and the priority of the completion 
address. 
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8. 3. 2. 1 Format of the Read/Write Request 


REQ 


RTJ- 


($F4) 




0 

15 

14 


1, 

RC 

2, 4. 

6 

9 

8 

X 

0. 1 

7 

4 

RP 

0-15 

3 

CP 

0-15 

0 



1 

15 

14 



c 

COMPLETION ADDRESS 






0 

4 .» 

«D 

2 

THREAD WORD = 0 

Vi 



14 

SHORT 



12 

M 

OO 

O 

-o 

9 



LOGICAL UNIT 



0 

« 

1 



masM 

[Sill!] 


0,1 

1 0 








u 

& 

4 

15 

0.1 

14 



a 

NUMBER OF WORDS 







0 



5 

15 

0.1 

14 



8 

FIRST WORD ADDRESS OF BUFFER 





0 



6 

15 




msb 

MOST SIGNIFICANT BITS OF MS ADOR. 




0 



7 

15 

0 

14 



iBb 

LEAST SIGNIFICANT BITS CW MS ADDR. 




0 




rc request code, 6 bits: WRITE = 2, READ = 1, FWRITE = 6, FREAD = 4 
X relative/ indirect indicator: 0 or 1 

rp request priority, 4 bits, 0-15: position of request on driver’s thread 
cp completion priority: 0-15 
c completion address, bit 15 set if (c) 

thread word, is used by the system: equals zero when request is not active, non- 
zero when active 

V error code passed to the completion address inQ and set in the parameter 
list when the request is completed 
m mode bit: 0 = binary, 1 = ASCII 
9 . logical unit, 10 bits; modified by a 

a settings for the a parameter (logical unit address indicator), 2 bits: 


a = blank =(S) : C is a logical unit number 
a = R = 01: £ is a signed increment (+1FF) 

a = I = 10: 2 is a core address (0<£<3FF) 

s starting word of storage block, bit 15 set if (s) 
msb-lsb set up by the programmer if logical unit specifies a mass storage device 


The type of addressing used is determined by the request code. Backgroimd pro- 
grams can access scratch only; sector 0, word 0 refers to the first word of 
scratch. These two words should be included in the request only if a mass storage 
device is involved. The macro call does not assemble them so the code must be 
added for them. 
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8. 3. 2.1 


The macro call is: 

FREAD 

REQ READ 2, c, s,n, m, rp, cp, a,x 

FWRITE 
WRITE 

REQ will be on the 54F4, which will be generated. REQ+1 is the first word of the 
parameter string. The parameter list is the same for all four of the Read/ Write 
requests. 

An example of a coded call would be: 


RTJ- 

($F4) 

NUM 

$0C01 

ADC 

COMPL 

NUM 

0 

NUM 

$1004 

NUM 

35 

ADC 

BUF 


8. 3. 2. 2 Request Code 


There are four input/output requests handled by the Read/ Write request processor 
RW, which has entry points Tl, T2, T4, T6 for them. 


Request Code NUM 


READ 1 $02XX 

FREAD 4 $08XX 

WRITE 2 $04XX 

FWRITE 6 $0CXX 


The manner in which the data is to appear on the device is determined by which 
form of the request is used. FWRITE and FREAD are used for formatted trans- 
fers and READ and WRITE are used for unformatted transfers. 


8. 3. 2. 2. 1 Format of Records 

The format in which data may appear on a device is different for each device and 
driver. This inf or mati on is given in the manual for each driver. The record 
formats for devices included in the minimum equipment configuration are outlined 
on the following page. 
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8.3.2. 2. 1.1 


8. 3. 2. 2.1.1 Teletype 


FREAD 

A format record for a teletype read operation consists of any number of characters 
followed by a carriage return. Format reading continues imtil a carriage return 
is detected or the requested number of words is transferred. If the requested 
number of words is transferred before the carriage return is detected, reading 
continues but no more data is transferred. A delete character will terminate data 
transfer imtil the next carriage return. The request will then be repeated. Line 
feed characters are not transferred in a format read. Before a f o r m a t read on 
the teletypewriter begins, the break light is turned on; therefore, type in must be 
preceded by pressing the break release. 

FWRITE 

A format record for a teletype write operation consists of any number of charac- 
ters following a carriage return and line feed character. A format write is the 
same as an ordinary write except that the driver supplies a carriage return and 
line feed character before beginning the transfer of data for a format write 
request. 

READ 

In an unformatted read, the number of words requested is filled starting at the 
specified address. Two characters fill one word; the first character is put into 
the upper half of the word. All carriage control must be provided by the program- 
mer. 

WRITE 

hi an unformatted write, two characters are transferred per word. The infor- 
mation must be stored in ASCII since no conversion is made from binary. 

8. 3. 2. 2. 1. 2 Paper Tape Reader and Paper Tape Punch 

A format record for the paper tape reader and punch depends on mode, hi ASCII 
mode, it is any number of characters preceding a carriage return, hi binary 
mode, it is any number of words preceded by a word which represents the ones 
complement of the number of words to be transferred and followed by a word con- 
taining a checksum. If the number of words to be transferred is greater than 
21, 759, the first word represents the ones complement of the number of words to 
be transferred plus 256. 

If the first character of the header word in a format record (requested in binary 
mode) is an asterisk, the r ec ord is read in ASCII mode. This allows ASCII and 
binary mode records to be mixed. 
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FREAD, ASCII 

For a f o r m a t read, ASCII mode, characters are read until a carriage return is 
detected or the requested number of words has been transferred. If the requested 
number of words is transferred before a carriage return is detected, reading will 
continue but no additional data will be transferred. Nulls (blank tape) preceding 
a format record are skipped; no data transfer takes place until a non-blank char- 
acter is detected. Line feed characters detected during the read are not trans- 
ferred; delete characters are ignored. All characters are checked for even 
parity. 

FREAD, Binary 

Format reading in binary mode continues until the word count is exhausted or the 
requested number of words has been transferred. If the latter occurs before the 
count is exhausted, reading will continue but no additional data will be transferred. 
The checksum is verified after the entire record is read. If the first character 
of the header word is an asterisk, the record is read in ASCII mode in spite of the 
binary mode declaration. Nulls (blank tape) preceding a format record are skipped. 

FWRITE, WRITE 

A format write is the same as an ordinary write request except the driver supplies 
carriage return and line feed characters after the end of the operation. 

In ASCn mode format write, characters are transferred from the specified core 
block' until the word count is exhausted. A parity bit is added to each character. 
In binary mode, format write, characters are transferred until the word coxmt is 
exhausted. Word coxmt is the first word on the tape and is the ones complement 
of block size. The driver supplies a checksum word after the data. 

Checksum 

The driver generates the checksum word on a paper tape by accumulating a sum 
of the word count word (which is the complement of the data block size and is out- 
put on the tape first) plus all the data words, disregarding any overflow. This 
sum is then complemented and output as the last word in the block on the tape. 
For example, if the data words are $F001, $E001, $E002, $E003, and $B005, the 
word coxmt will be 5 and the sum of the data 4010, The checksum will be $BFF4 
which is $FFFA (complement of 0005) plus $4010, which is $400B; the comple- 
ment of $400B is $BFF4. The tape will contain FFFA, FOOl, EOOl, E002, E003, 
B005, BFF4. 

When the checksum word is read on input, it will result in zero when the word 
coxmt word is read, the data words added to it, and then the checksum word is 
added to that. For example, on the above tape the word coxmt word FFFA is read 
first, the data totalling 4010 is added to it as the data is read, giving 400B. When 
the checksum BFF4 is read and added, the sum will be FFFF arithmetically, 
which will be 0000 by the subtractive adder. 

The paper tape on page 8-14 contains the data used in these examples. 
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The following example program shows the paper tape output for all four kinds of 
writes. It writes 100 words of data from a buffer BUF. The data in the buffer is 
l-64^g (1-100^^). The bxiffer is written out from the end to the beginning. 


0001 NAM 

0002 ENT 

0003 POOOO 0000 WRITE 0 

0 0 04 

0005 

0006 POOOl 0C63 ENO 

0007 P0002 OAOO EMA 

0008 P0003 0901 DATA IMA 

0009 P0004 6A21 5TA<^ 

0010 P0005 014? SQZ 

0011 P0006 ODFE IMQ 

0012 P0007 18FB JMP<^ 

0013 ^ 

0014 

0015 POOO^^ 54F4 PUNCH RTJ- 

0016 P0009 0401 NUM 

0017 POOOA 0000 NUM 

0018 POOOB 0000 NUM 

0019 POOOC 0003 NUM 

0020 POOOD 0064 NUM 

0021 POOOE 0025 » ADC 

0022 

0023 POOOF 54F4 RTJ- 

0024 POOlO 0401 NUM 

0025 POOll 0000 NUM 

0026 Pool? 0000 NUM 

0027 P0013 1003 NUM 

0028 POO 14 0 064 NUM 

0029 P0015 0025 P ADC 

0030 

0031 P0016 54F4 RTJ- 

0032 P0017 OCOl NUM 

0033 POO 18 0000 NUM 

0034 P0019 0000 NUM 

0035 Pool A 1003 NUM 

0036 POOIR 0064 NUM 

0037 POOIC 0025 P ADC 

0038 * 

0039 POOID 54F4 RTJ- 

0040 POOIE OCOl NUM 

0041 POOIF 0000 NUM 

004? P0020 0000 NUM 

0043 P0021 0003 NUM 

0044 P0022 0064 NUM 

0045 P0023 0025 P ADC 

0046 

0047 P0024 14EA JMP- 

0048 P0025 0064 BUF BZS 

( ) 0049 END 


TEST WRITE INSTRUCTIONS 
WRITE 
0 

THIS IS HOW TO GENERATE DATA 
IN A PROGRAM FOR A TEST 

99 
0 

1 

BUF^Q 

PUNCH-5^-1 

-1 

DATA 

WRITER BINARY 

(SF4) 

S0401 

0 

0 

S0003 

100 
BUF 

WRITER ASCII 

($F4) 

S0401 

0 

0 

$1003 

100 

BUF 

FWRITEf ASCII 

($F4) 

SOCOl 

0 

0 

$1003 

100 

BUF 

FWRITEf BINARY 

($F4) 

SOCOl 

0 

0 

S0003 
1-0 O'- 
BUF 

(SEA) 

BUF(IOO) 

WRITE 
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8. 3.2.2. 1.3 


8. 3. 2. 2. 1. 3 Mass Storage Addressing 

When the logical unit in a read/write request specifies a mass storage device, 
the address to be accessed must be in the two words following the parameter list. 
This must be set up by the programmer. For example: 


READ 

NUM 


>>»»>»»» 

$0000, 0002 


(sector 2) 


Since all transfers to and from mass storage do not have a mode or format as- 
sociated with them; that is, what is written on the disk is a mirror image of the 
contents of core, the. formatted and unformatted forms of the request determine 
the type of addressing that will be used. Formatted requests mean sector addres- 
sing and Read/Write assumes word addressing. Check the manual for the 
driver for the exact details of addressing mass storage. Sector addressing can 
always be used; word addressing can only be used under systems which have the 
disk word driver. 

hi the background a program can access only the scratch area of the disk or drum 
through read/write requests. Therefore, sector one or word one in the back- 
ground is sector or word one of the scratch area. 

8. 3. 2. 3 XBit 

The X bit is used in conjunction with the cp, n, and s parameters to indicate 
direct, indirect, or relative location of those parameters. It will be discussed 
as it relates to each parameter. 

As a rule, the x bit = 0 is satisfactory for background programs, with all the 
associated parameters direct. 


8 



0 


0 

c 



0 

n 

0 

s 


Its use as relative (for run anywhere programs) will be discussed in detail in 
Chapter 11. When the x bit = 1, the c and s parameters must be relative! 
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8. 3. 2. 4 


A 

8,3.2. 4 Request Priority 

The request priority indicates to the operating system the priority of this request 
in relation to the other programs requesting use of the device. The request 
priority has nothing to do with the running priority of the program. In the back- 
ground the rp parameter is always 0. 

Since the request priority determines the position of the request on the queue for 
the driver, the reads and writes done by jobs at priority 0 will always be on the 
bottom of the queue and therefore will be done last. 

This is why, for example, if a job and a process program are both writing mes- 
sages on a remote teletype, the messages will be interspersed together with the 
process program’s messages taking priority over the job’s. 

8. 3. 2. 5 Completion Priority 

The completion priority is the priority at which the completion routine is to run. 

For background jobs, cp is always 1. Since the running priority for jobs is al- 
ways 0, the completion priority of 1 will cause the job to be interrupted, when the 
driver has finished the l/ O, and the completion routine to be entered. (When the 
completion routine exits, control is returned by the dispatcher to the location 
where the job was interrupted. ) 

A completion priority greater than the running priority will always cause a pseudo 
interrupt of the program and will cause the priority to be changed higher and the 
completion address entered. A cp equal to or less than the rimning priority will 
cause the completion routine not to be entered until after the program exits and 
the priority structure works down to the desired level. 

8. 3. 2. 6 Completion Address 

The completion address is scheduled by the driver as a program when the transfer 
is completed, or terminated by an error. The completion address is scheduled at 
a particular priority specified by the cp parameter, hi the background cp is 
always 1. 

This completion routine is generally short because, under the utility system, 
when it is entered the interrupt mask is set to prevent external interrupts from 
occurring. Under MSOS, interrupts are not locked out while the completion rou- 
tine is being executed, so process equipment can interrupt. 

The completion address may be omitted; then no address is scheduled upon com- 
pletion. 

When control is given to the completion address, the Q register will contain a 3- 
bit code in the upper three bits of Q. These bits can also be found in the v field 
of the fourth word of the request. 
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Bit 

15 

14 


13 


Value Condition 

0 Error free operation 

1 Error occurred (device failure) 

0 Requested number of words transferred 

1 Less than requested number of words trans- 

ferred during a read or format read (short 
read) 

0 Error occurred because device was not ready 

1 Error was due to failure of the device; de- 
vice is ready 


The Q register should always be checked for the possibility that an error occurred. 
For example, if a short read occurred on a READ request, bit 14 would equal 1. 
Bit 15 would indicate whether it was a legal short read (Q15=0), or due to device 
failure (Q15=l). If it was due to device failure, bit 13 would indicate whether the 
device is ready or not. 

The programmer could find out how much of the data was transferred by the last 
word of the data buffer. This word would contain the address plus 1 of the last 
word transferred. Thus, by subtracting the contents of the last word in the buffer 
from the first word address of the buffer, the number of words can be found. If, 
for example, a read of 50 words was requested but only 25 words were read: 

BUF 


BUF+24 


BUF+49 


25 words 
read 


BUF+25 


LDA =XBUF (A) = BUF 

SUB BUF+49 - BUF+25 

(A) = 25 


Each appropriate driver manual will indicate possible error conditions. 

The completion address may be specified in several ways. The x parameter 
determines the mode of addressing that is used for the completion address. 
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8. 3.2. 6 


X 

c 

The meaning of c 

0 or blank 

c 

c is the completion address 

7^0 

T^blank 

c 

e. g. , FWRITE -, COMPL, -, -, -, -, -, -, 0 
COMPL is assembled as an absolute address 
(program relocatable). 

c is relative 



c is a positive increment added to the address 
of the first word of the parameter list to locate 
the completion address. 



i. e., FWRITE -, COMPL- *+l, -,X 
hi the example the completion address is at 
COMPL. 

- 

(C) 

c in parentheses represents an index to the sys- 
tem library, x has no meaning. 


Note that there is no indirect version for the completion address. 

The option (c) cannot be used in the background because the programs on the 
system library may not be scheduled from the background; see Chapter 11. 

A completion routine in one’s own program may be scheduled in one of the fol- 
lowing ways: 


0001 

0002 

0003 

0003 

0003 

0003 

0003 

0003 

0004 
0004 

0004 

0005 

0006 
0006 
0006 
0006 

0006 

0006 

0007 

0007 

0007 

0008 


POO 00 54F4 
POOOl OCOl 
P0002 0009 P 
P0003 0000 
P0004 0004 
P0005 0009 
P0006 OOIAP 


P0007 54F4 
P0008 OAOO 


POOOB 54F4 
POOOC ODOl 
POOOD 0008 
POOOE 0000 
POOOF 0004 
POOlO 0009 
POOH OOOE 


COMPLl 


P0012 54F4 
P0013 OAOO 
POOH 0172 COMP2 


NAM D - R/W EXAMPLE 
ENT GO 

FWRITE 4, COMPLl, EXAMPLE, 9, B, 0, 1, A, 0 
\ \ 
completion address 


EXIT 


FWRITE 4, COMP2-*+l, EXAMPLE-*+5, 9, B, 0, 1, A, X 
Relative distance to completion address 


EXIT 

SQM ERROR 
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Note that the first assembles with a P following the completion address, meaning 
that it is direct and will be absolutized at load time (the actual core address filled 
in); so the program will be relocatable. 

The second example is relative to the first word of the parameter list. Also, in 
the second example, note that the 8 refers to the location where the parameter 
is but that the parameter address must be relative to the first word of the para- 
meter list, hence COMP2-*+l. The x bit must be set in the first word. 

8. 3. 2. 7 Thread Word 

The thread word must always be initialized toO or the request cannot be executed. 
The thread word is used by the operating system for the queue for requests and 
also for the completion. It is non-zero during the entire time the request is being 
processed and while the l/O is being done. It does not become zero again until 
the operation is complete. 

8. 3. 2. 8 Error Code 

The 3-bit v field in the fourth word of die parameter string is the same 3-bit 
error code that comes back to the Q register at completion. It will be set by the 
driver whether or not there is a completion routine. Therefore, a program not 
using a completion routine may check the v field for errors. 

8. 3. 2. 9 Mode 

The m parameter tells the driver whether the data is stored in core in Binary 
or ASCII. When m is A (or, if coded, 1) it means the data is stored in ASCII, 
and B (or, if coded, 0) means Binary. 

8. 3. 2. 10 A Field 

The a bits modify the logical unit field, indicating whether the logical unit field 
contains the actual logical unit number, an indirect address containing the LUN, 
or a relative distance to LUN. The a bits will be discussed under the logical unit 
heading. 

8. 3. 2. 11 Logical Unit 

The logical unit may be specified directly (i. e, , C =4), a word may be specified 
that contains the logical unit, or a relative distance to the address of the LUN may 
be specified. The a parameter indicates which form of the parameter the pro- 
grammer has used. 


V 



8.3.2.11 


a 

= 0 or 1 
= A or > 
= blank j 
= 2 or I 


= 1 or 
= R 


Meaning; of the € parameter 
the parameter is the logical unit 
e. g. , FWRITE 13, 0, - 

j2 is indirect 

C is an absolute location that contains the logical unit 

e. g. , FREAD $FD, I, - 

is used when standard comments (input) wanted. C can- 
not be larger than $3FF. 

C is relative 

£ is a number that specifies the number of words to a 
word that contains the logical unit. The £ parameter 
in this case can be positive or negative but must not 
exceed + or - $1FF. 

e. g. , READ LUN-*+3, R, - 

where LUN contains the logical unit. 


Note the restriction that when using the I option the absolute address must be 
within the range of 000 to 3FF which in most cases precludes the use of the I 
option when the location is within ones own program, except for system units. 

The following are the core locations in the operating system which contain the 
logical unit numbers of the standard devices: 


Device Core Location 

Input comment device $FD 

Output comment device $FC 

Standard print output device $FB 

Standard binary output device $FA 

Standard input device $F9 

Mass storage library $C2 

Mass storage scratch $B3 


Each piece of equipment has a logical imit number assigned to it for the system 
to use. Also, one piece of equipment may have more than one logical unit number, 
depending on the use. It is not to be confused with the equipment number dialed 
on the controller nor with the unit number set on the unit (i. e. , tape unit). It 
could be thought of as the system number of the driver. 
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The logical unit numbers will be different at each installation but the following 
numbers are very commonly used: 

2 - PTR 

3 - PTP 

4 - TTY 

5 - CR 

6 - MT #1 

7 - MT #2 

8 - DISK 

9 - LP, system driver 

10 - LP, FORTRAN driver 

If the programmer does not want to change the logical xmit for this request, during 
his program he could specify it directly, as in the following example. 


0001 




NAM A R / W EXAMPLE A 

0002 




ENT START 

0003 


0003 


EQU PTP(03) 

0004 

POOOO 

FOOl 

BUF 

NUM $F001, $E001, $E002, $E003, $B005, $C004 


POOOl 

EOOl 




P0002 

E002 




P0003 

E003 




P0004 

B005 




P0005 

C004 



0005 



START 

FWRITE PTP, XX, BUF, 5, B, 0,1,, 0 

0005 

P0006 

54F4 



0005 

P0007 

OCOl 



0005 

P0008 

OOOF P 




P0009 

0000 



0005 

POOOA 

0003 


— logical \uiit 

0005 

POOOB 

0005 




POOOC 

0000 P 





Note that the assembler put 0003 in the logical unit position (POOOA) of the code for 
the FWRITE. Note also that only 5 of the 6 words in the buffer were written out. 
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See also the logical unit specification in the macro calls in the completion address 
example in section 8. 3. 2. 6. The A specified that the logical unit field (4) was ab- 
solute. 

On the other hand, if the programmer wanted to use one of the standard devices, 
such as the comment device, he would specify an indirect address in the following 
form: 


0004 


XI 

FWRITE $FC, XB, STATEM, 17, A, 0, 1, 1, 0 

0004 

POOH 

54 F4 

\ \ 

0004 

P0012 

OCOl 


0004 

P0013 

OOIA P 


0004 

P0014 

P0015 

0000 

18FC 

— location containing LUN 

0004 

P0016 

P0017 

0011 
0000 P 



The programmer may want to change the logical unit, depending on the conditions 
in his program; therefore, he may have a location within his program in which to 
store the logical unit number. The following example would be a way to code a 
program to write one message (from M21) on a LOG unit and the COMMENTS unit, 
then write another message (from M22) on the COMMENTS unit only. The entry 
point is GO TO, and LOG is EQU’d to the LOG unit while COMMENTS is EQU’d to 
$FC. Note that the word in the program which contains the logical unit number 
must be addressed relatively because its absolute address may not fit in the 10- 
bit £ field. Note also that the completion and buffer addresses may be addressed 
absolutely in this same macro call because the x bit is not set for a relative logi- 
cal xmit word. 
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0003 

POOOO 

5448 M21 

ALF THIS MESSAGE APPEARS ON THE LOG* 


POOOl 

4953 


0004 

POOlO 

414E M22 

ALF *, AND THIS ON THE COMMENTS DEVICE. * 

0005 

P0020 

0001 LUNIT 

BSS LUNIT 

0006 

P0021 

OBOO XI 

NOP 

0007 



FWRITE LUNIT-*+3, COMPLETE, M21, 16, A, 0, 1, R, 0 

0007 

P0022 

54F4 

\ \ 

0007 

P0023 

OCOl 

0007 

P0024 

002B P 



P0025 

0000 


0007 

P0026 

17FC ^ 

■ relative distance to LUNIT 

0007 

P0027 

0010 



P0028 

0000 P 


0008 



EXIT 

0008 

P0029 

54F4 


0008 

P002A 

OAOO 


0009 

P002B 

1CF5 COMPLETE JMP* (XI) 

0010 

P002C 

COOO GOTO 

LDA =XLOG 


P002D 

OOOB 


0011 

P002E 

68F1 

STA* LUNIT 

0012 

'P002F 

58F1 

RTJ* XI 

0013 

P0030 

017E 

SQM ERROR 

0014 

P0031 

COFC 

LDA COMMENTS 

0015 

P0032 

68ED 

STA* LUNIT 

0016 

P0033 

58ED 

RTJ* XI 

0017 

P0034 

017A 

SQM ERROR 

0018 



FWRITE $FC, OK, M22, 17, A, 0, 1, 1, 0 

0018 

P0035 

54F4 


0018 

P0036 

OCOl 


0018 

P0037 

003E P 



P0038 

0000 


0018 

P0039 

18FC 


0018 

P003A 

0011 



P003B 

0010 P 


0019 



EXIT 

0019 

P003C 

54F4 


0019 

P003D 

OAOO 


0020 

P003E 

0170 OK 

SQM ERROR 
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What other information does the programmer need to supply the operating system 
to perform an I/O operation? The operating system needs to know how many 
words are to be transferred, where in core the information is stored for a write 
operation or, for a read, where it is to be stored. This is done by specifying the 
remaining parameters. 


8. 3. 2. 12 Number of Words 

The n parameter is the number of words requested to be transferred. A read will 
transfer one record, so if less than the requested number of words is in the 
r e c o r d (i. e. , on paper tape, see 8. 3. 2. 2. 1, 2) a short read will occur. This is 
perfectly legal since it allows the programmer to specify a maximum but get the 
actual number. 

The location of the number of words can be specified in several ways; 

X Meaning of n 

n n is the length of the block to be transferred; x 

has no meaning. 

e.g., FWRITE 6, - 

In this case 6 words would be transferred. 


=0 (n) 

=blank 


/O (n) 

/blank 


n is indirect. 

It is a core location containing the block size. 

e. g. , WRITE -, -, -, (n), -, -, -, -, 0 
n contains the block size. 

n is relative. 

It is the relative distance to a corelocation con- 
taining the block size. 

e.g., READ (N-*+4),-, X 

N in this case contains the number of words to 
be transferred. 


See the other read/write examples for illustrations of the n parameter. 

8. 3. 2. 13 Starting Address of Buffer 

The location in core in which the data to be transferred is stored is indicated by 
the s parameter. The s refers to the first word of the data block. The buffer 
address can be specified in several ways, again in conjunction with the x bit. 
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X _s 

=0 s 

=blank 


=0 (s) 

=blank 


^0 s 

T^blank 


^0 (s) 

T^blank 


Meaning 

s is the starting address of the data block in 
core. 


e.g., FWRITE BUF, 0 

where BUF is the starting address. 

s is indirect. 

It is the core location that contains the absolute 
address of the data block. 

e.g., READ (BUFADR),-,-, 0 

BUFADR contains the absolute address of the 
starting address. 

s is relative. 

s is a positive increment added to the address 
of the first word of the parameter list to form 
the starting address. 

e.g., FREAD BUF-*+5, X 

BUF would be the first word of the data block. 

s is double relative. 

s is a positive increment added to the address 
of the parameter list to form the address of a 
word that contains another relative indicator. 
This indicator is added to the first word of the 
parameter list to form the address of the data 
block. 

e. g. , WRITE -, -, (BUFREL-*+5), -, -, -, -, -, X 
BUF RE L contains a number to be added to the 
first word of the parameter list to locate the 
buffer. 


The above specifications mean one can specify the address directly, relatively 
or indirectly. If the buffer were within one’s program and if the request were 
always going to deal with this one buffer, one could reference in one of the fol- 
lowing ways. 
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0001 

0002 


0003 

0004 
0004 
0004 
0004 

0004 

0004 

0005 
0005 

0005 

0006 


0007 

0007 

0007 

0007 

0007 

0007 

0008 
0008 
0008 
0009 


POOOO 5448 STATEM 

POOOl 4953 

P0002 2049 

P0003 5320 

P0004 414E 

P0005 2045 

P0006 5841 

P0007 4D50 

P0008 4C45 

POOOO 2046 

POOOA 4F52 

POOOB 2053 

POOOC 2050 

POOOD 4152 

POOOE 414D 

POOOF 4554 

POOlO 4552 


POOH 54F4 
P0012 OCOl 
P0013 OOIA P 
P0014 0000 
P0015 18FC 
P0016 0011 
POOH 0000 P 

P0018 54F4 
POOlO OAOO 
POOIA 0179 XB 


POOIB 54F4 
POOIC ODOl 
POOID 0009 
POOIE 0000 
POOIF 18FC 
P0020 0011 
P0021 7FE3 

P0022 54F4 
P0023 OAOO 
P0024 181C ERl 


NAME - R/W EXAMPLE 

ALF *, THIS IS AN EXAMPLE FOR S PARAMETER* 


ENT XI 
FWRITE 


$FC, XB, STATEM, 17, A, 0, 1, 1 

\ 


Starting Address 
EXIT 


SQM ERl 

FWRITE $FC, XC-*+l, STATEM- *+5, 17, A, 0, 1, 1, X 

\ \ 


Starting Address, Relative 
EXIT 


JMP* ERROR 
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The second example shows that even though the relative address must be in the 
positive direction the data block can come before the request in the program. 
This makes use of the wrap-around feature of the machine's 15-bit address arith- 
metic. 

1C + 7FE3 = 7FFF, which is a zero in 15 bits, indicating POOOO. 

If, on the other hand, the request may be used to read or write a number of 
data tables, an indirect method might be used. 


0010 

P0025 

COOO 

XC 

LDA =XSTATEM 


P0026 

0000 P 



0011 

P0027 

6818 


- STA* PT 

0012 




FWRITE $FC,XD, (PT),17, 

0012 

P0028 

54F4 



0012 

P0029 

OCOl 


\ 

0012 

P002A 

0031 P 




P002B 

0000 



0012 

P002C 

18FC 



0012 

P002D 

0011 




P002E 

803F ^ 


— Starting Address, Indirect 

0013 




EXIT 

0013 

P002F 

54F4 



0013 

P0030 

OAOO 



0014 

P0031 

017C 

XD 

SQM ER2 

0015 

P0032 

COOO 


LDA =XSTATEM-EX-1 


P0033 

7FC9 



0016 

P0034 

680B 


STA* PT 

0017 



EX 

FWRITE $FC, EC-*+l, (PT- 

0017 

P0035 

54F4 



0017 

P0036 

ODOl 



0017 

P0037 

0006 




P0038 

0000 



0017 

P0039 

18FC 



0017 

P003A 

0011 




P003B 

8009 



0018 



EC 

EXIT 

0018 

P003C 

54F4 



0018 

P003D 

OAOO 



0019 

P003E 

1802 

ER2 

JMP* ERROR 

0020 

P003F 

0001 

PT 

BSS PT 


\ 
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8. 3. 2. 14 Setting Up RW requests in Background 

Jobs are supposed to run at priority 0 and their completion routines are supposed 
to run at priority 1. There are three ways the input/output requests can be set 
up (for jobs) to maintain control in the program. 

1. Looping on the thread word 

2. Looping on a flag set by the completion routine 

3. Scheduling out of the completion routine 

The example to use would be an input of a card buffer which would then be written 
on the teletype. 


8. 3. 2. 14. 1 Looping on the Thread Word 



RTJ- 

($F4) 



NUM 

$0801 

FREAD 


NUM 

0 

NO COMPL 

THR 

NUM 

0 



NUM 

$1002 

ASCII, PTR 


NUM 

35 

35 WORDS 


ADC 

BUF 


WAIT 

LDA* 

THR 



SAZ 

WRITE-*-! 



JMP* 

WAIT 


WRITE 

- 

- 


The thread word will be non 

-zero until the input is finished; t 

written out. 

This technique hangs the computer in a loop am 

priority operations. Of 

course, a job is 

running at 0 so 

However, this method should not ever be used in foreground 

8. 3. 2. 14. 2 Looping on a Flag 




RTJ- 

($F4) 



NUM 

$0801 

FREAD 


ADC 

COMPL 

COMPL 


NUM 

0 



NUM 

$1002 

ASCII, PTR 


NUM 

35 

35 WORDS 


ADC 

BUF 


WAIT 

LDA* 

FLAG 



SAN 

WRITE 



JMP* 

WAIT 


WRITE 

ENA 

0 



STA* 

FLAG 
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COMPL 

EXIT 

SQM 

ENA 

STA* 

ERR-*-l 

1 

FLAG 

> 


ERR 

EXIT 



> Closed Routine 

FLAG 

JMP* 

BSS 

COMPL+1 

FLAG(l) 

J 


This method does the same thing as looping on the thread word, except it provides 
for a completion routine where errors can be checked. It should not be used in 
the foreground either because it locks out priorities lower than the completion 


priority. 


8. 3. 2. 14. 3 Scheduling Out of the Completion Routine 
This method may be used only under MSOS. 



RTJ- 

NUM 

($F4) 

$0801 

FREAD 


ADC 

COMPL 

COMPL 


NUM 

0 



NUM 

$1002 

ASCII, PTR 


NUM 

35 

35 WORDS 


ADC 

BUF 

BUFFER ADDR 

COMPL 

EXIT 

SQP 

OK-*-l 

CHECK ERRORS? 

OK 

RTJ* 

SCHDLE 

ERR 

WRITE, 0,0 

SCHEDULE WRITE 

WRITE 

EXIT 




This method provides for an exit immediately after the request is initiated at 
priority 0, to wait for completion. When the completion routine is entered at 
priority 1, a check is made for errors and then a schedule request is made for 
the address WRITE to be entered at priority 0, after the completion routine does 
its exit. (The schedule request is covered in the next section. ) 

Scheduling out of the completion routine is a good method to learn to use because 
it can be used by either backgroimd or foreground programs, it maintains a 
priority scheme if it is desired that the l/O completion routines run at a different 
priority from the main body of the program (either higher or lower), and it does 
not lock out lower priority operations. 

Any coding which can be done in the program before the data is needed can be 
inserted after the ADC BUFand before the EXIT. That coding will run at priority 
0, the priority of the main body of the program. 
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A method similar to this is often used; it works in the background but does not 
maintain any priority scheme: 



RTJ- 

($F4) 

\ 




NUM 

$0801 





ADC 

COMPRD 





NUM 

0 


> 

Initiate Read 


NUM 

$1002 




NUM 

35 





ADC 

BUF 





EXIT 





COMPRD 

SQP 

WRITE- *+l 




RTJ* 

ERR 




WRITE 

RTJ- 

($F4) 





NUM 

$0C01 





ADC 

COMPWR 


> 

Initiate Write 


NUM 

0 





NUM 

$1004 





NUM 

35 





ADC 

BUF 





EXIT 





COMPWR 

! 






hi the above example, the read is initiated at priority 0. When the first comple- 
tion routine is entered, COMPRD, the priority would change to 1 and would never 
drop back to 0 during the remainder of the program. Therefore, the write will 
be initiated at 1, not 0. However, if it were desired to have completion routines 
run higher, the cp in the write request would have to be 2 (illegal in jobs) and 
each subsequent request would have to have a higher completion priority. This 
would be rather sloppy in the foregroimd. 

This method could not be used under the utility system because interrupts would 
be locked out at the beginning of the first c omple ti on routine. The schedule 
method could not be used under utility either, because the schedule request is 
not available under utility. 

8. 3. 2. 15 Examples of Programs Using l/O Requests 

The following two programs read one card into a buffer (BUF) from the card 
reader, logical unit 12. They then print the card on the teletypewriter. The 
first program uses system macro requests; the second program codes the system 
calls. 
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Read Completion Routine at 

Write Completion Priority 1 


8.3.2.15 


JOB 


0001 

0002 

0003 

0004 

0005 

0006 

0007 

0008 
0009 
0009 
0009 
0009 

0009 

0009 

0010 
0010 
0010 

'’OOll 

0012 

0013 

0014 
J 0014 

0014 

0014 

0015 

0015 
^0015 

0016 
0017 
0017 
0017 
0017 

0017 

0017 


NAM CARD TO PRINT 


♦THIS PROGRAM USES SYSTEM REQUESTS TO READ AND WRITE 



* 

ENT 

START, PRINT 




EXT 

lOERR -m 

■ error subroutine 

POOOO 0028 

BUF 

* 

BSS 

BUF(40) ^ 

• data buffer 


START FREAD 12, COMPRD, BUF,40, A, 0, 1, , 0 Formatted Read Macro 


P0028 

54 F4 

/ t t i 




P0029 

0801 

LUN 12 COMPL 1 



1 X bit = 0 

P002A 

0031 P 

ADDR Buffer 



CP= 1 

P002B 

0000 



1 RP= 0 

P002C 

lOOC 


1 ASCII mode 

P002D 

0028 

40 words 

P002E 

0000 P 

Read is initiated 





EXIT 


EXIT Macro 

P002F 

54F4 

Jump to dispatcher (EXIT Request) 


P0030 

OAOO 

No work to do until Read completed 




Read completed * 

P0031 0162 ^COMPRD SQP SCHPRT Q15 = 0 if no Read error 

P0032 5400 X RTJ lOERR Q15 = 1 if error 

P0033 7FFFX 




SCHPRT SCHDLE PRINT, 0, 0 Schedule Macro 

Schedule PRINT at | X bit = 0 

priority 0 before exit RP = 0 

from completion routine 

P0034 

P0035 

P0036 

54F4 
1200 
0039 P 



EXIT 

P0037 1 

54F4 

Jump to dispatcher at end of completion 

P0038 

OAOO 

Dispatcher will now go execute PRINT at priority 0 


* 


P0039 

54F4 

P003A 

OCOl 

P003B 

0042 P 

P003C 

0000 

P003D 

18FC 

P003E 

0023 

P003F 

0000 P 


PRINT 


FWRITE 


Contains 

LUN 


$FC, COMPPR, BUF, 35, A, 0, 1, 1, Q Formatted Write Macro 


t 

COMPL 
ADDR 

Buffer 


Write is initiated 


I X bit = 0 
Indirect bit for LUN 
CP= 1 
RP = 0 
ASCII mode 
35 words (on TTY) 


0018 

0018 

0018 

P0040 

P0041 


EXIT 

Jump to dispatcher 

No work to do imtil Write completed 

EXIT Macro 

54F4 

OAOO 

0019 



* 




0020 

P0042 

0162 

COMPPR 

SQP 

FINI 

NO lO ERR 

0021 

P0043 

5400 X 


RTJ 

lOERR 



P0044 

0033 X 





0022 



FINI 

EXIT 


EXIT Macro 

0022 

P0045 

54F4 





^0022 

P0046 

OAOO 






0023 END START 


Entry points 


I OOFF START 0028P PRINT 

SCHPRT 0034P COMPPR 0042P FINI 


0039P BUF OOOOP COMPRD 0031P 
0045P lOERR 0044X 


0001 


NAM 

lOERR 

0002 


ENT 

lOERR 

0003 POOOO 

18FF 

lOERR 0 

0 

0004 


NUM 

$18FF « 



END 


CARD 

2210 

j where pgms loaded 


lOERR 

2257 



l/O subroutine 

Hang instruction used for 
checkout 


I OOFF lOERR OOOOP 
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Reads and writes initiate l/O. Control returns to next instruction in program before l/O 
is done. Job l/O is done at priority 0. Program should not loop waiting for l/O to be 
done. 

Completion address is entered when l/O is done, at priority 1. It should be short and 
exit to dispatcher. Check Q for l/O errors. 

This JOB does not check Q after Request, to see if Request accepted (Q15 = 0). Jobs do 
not have to but system programs must. 



WWVNAAAA 

TTY Printout 


*p 

J 

*ASSEM 

J 

*p 


J 

*L,8 
J 

THIS PROGRAM WORKS ON THE 1700 COMPUTER SYSTEM UNDER MSOS 2. 0 
J 


-No MAP 


Formatted Write 


For program checkout, hang instruction could also be used to see if completion routine 
entered. 


0019 



* 



0020 

P0042 

0172 

COMPPR 

SQM 

HANG 

0021 




EXIT 


0021 

P0043 

54F4 




0021 

P0044 

OAOO 




0022 

P0045 

18FF 

HANG 

NUM 

$18FF 

0023 




END 

START 
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EXAMPLE READ/WRITE PROGRAM 


JOB 


0001 




NAM 

CARD TO PRINT 


0002 




ENT 

START, PRINT 


0003 




EXT 

lOERR 


0004 


OOEA 


EQU 

ADISP ($EA) 


0005 

POOOO 

0000 

START 

0 

0 


0006 

POOOl 

54F4 


RTJ- 

($F4) 

Initiate FREAD 

0007 

P0002 

0201 


NUM 

$0201 

READ, CP = 1 RP = 0 

0008 

P0003 

0009 

P 

ADC 

COMPRD 

— Completion Address 

0009 

P0004 

0000 


NUM 

0, $100C 

THREAD, LUN CR= 12, ASCII 


P0005 

lOOC 





0010 

P0006 

0028 


NUM 

40 

ONE CARD TO READ 

0011 

P0007 

OOIF 

P 

ADC 

BUF 

FWA BUFFER AREA 


Control returns beneath parameter string after Read is initiated. If program has 
nothing to do, it should exit until completion routine is entered. Unprotected program 
can exit to dispatcher. 


0012 P0008 14EA JMP- (ADISP) 

When Read is finished control will go to completion address COMPRD. Completion 
routine should check bit 15 of Q for l/O errors and exit to dispatcher. 


0013 

P0009 

0162 


COMPRD 

SQP 

SCHPRT 


0014 

POOOA 

5400 

X 


RTJ 

lOERR 



POOOB 

7FFFX 





0015 

POOOC 

54 F4 


SCHPRT 

RTJ- 

($F4) 

Schedule PRINT at priority 0 

0016 

POOOD 

1200 



NUM 

$1200 

before exit, to drop priority 

0017 

POOOE 

0011 

P 


ADC 

PRINT 

back to 0. 

0018 

POOOF 

54 F4 



RTJ- 

($F4) 


0019 

P0010[ 

0A00| 

j 


NUM 

$A00 

EXIT REQUEST 


Dispatcher will pass control 

to Print after read completion routine exit. 

0020 

POOH 

54 F4 


PRINT 

RTJ- 

($F4) 


0021 

P0012 

0401 



NUM 

$0401 

PRINT, CP = 1 RP = 0 

0022 

P0013 

OOIA 

P 


ADC 

COMPPR 

COMPLETION ADDRESS 

0023 

POO 14 

0000 



NUM 

0, $1009,35 



P0015 

1009 





35 words on TTY 


P0016 

0023 






0024 

P0017 

OOIF 

P 


ADC 

BUF 

FWA BUFFER 


Control returns here after print is initiated. Exit Request is same as jump to dis- 


patcher. 






0025 

P0018 

54 F4 



RTJ- 

($F4) 


0026 

P0019 1 

1 OAOO 



NUM 

$A00 



After print is done, control goes to COMPPR at priority 1. Here exit from program. 

0027 

POOIA 

0162 


COMPPR 

SQP 

FINI 


0028 

POOIB 

5400 

X 


RTJ 

lOERR 



POOIC 

OOOB 

X 





0029 

POOID 

54F4 


FINI 

RTJ- 

($F4) 


0030 

POOIE 

|0A00 

1 


NUM 

$0A00 

EXIT WHEN THRU 

0031 

POOIF 

0028 


BUF 

BSS 

BUF(40) 


0032 





END 

START 
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8.3.2.15 


TTY Printout. Read/Write Program 
Not using system macros. 

Coding requests as in example will produce much faster assembly time than when using 
macros. 


^The E message noted unpatched externals (lOERR). The * typed by operator 
said to ignore them. 

EH4S PROGRAM WORKS ON THE 1700 COMPUTER SYSTEM UNDER MSOS 2. 0 
J 


^ output from WRITE 

Unformatted Write did not do line feed as there are no line feed/CR in unformatted Write. 


Formatted Write should be used on print devices such as TTY and LP. 

Unformatted Write on printer does not work correctly. The printer buffer is filled but 
the line is not printed until the next output line is sent to the printer. 
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8. 3. 2. 15 


Read formatted ASCII data records from paper tape into BUF area and type it out. 
Assume the BUF area is larger than the formatted record. Continue until the 
reader runs out of tape, giving an error. 



NAM 




ENT 

BEGIN 



BSS 

BUF(30),STAT(1) 


FLAG 

ADC 

0 

Flag for switching 

BEGIN 

0 

0 


START 

CLB 

A 



STA* 

FLAG 

Clear flag 

READIT 

RTJ- 

($F4) 

Format read LU2 is paper tape 


NUM 

$800 

reader where to go when fin- 


ADC 

READY 

ished 


NUM 

0, $1002,30 



ADC 

BUF 



LDA* 

FLAG 

Hang until flag set by comple- 


SAN 

1 

tion routine 


JMP* 

*-2 



LDQ 

STAT 



SQP 

MORE-*-l 



RTJ- 

($F4) 

Exit request on input error- 


NUM 

$A00 

end job 

MORE 

CLR 

A 

Clear flag 


STA* 

FLAG 

Hang until flag set by comple- 


RTJ- 

($F4) 

tion routine. Type out format 


NUM 

$coo 



ADC 

READY 



NUM 

0, $1004,30 



ADC 

BUF 



LDA* 

FLAG 



SAN 

1 



JMP* 

*-2 



JMP* 

START 


READY 

RAO* 

FLAG 

Completion routine sets flag 


STQ 

STAT 

Exit back to program 


RTJ- 

($F4) 



NUM 

$A00 




8.3.3 


8. 3. 3 Schedule Request - Request Code 9 

The schedule request is available only under MSOS. 

Programs occur in the 1700 rxm at 16 different priorities, 15 (high) to 0 (low). A 
program can schedule a section of coding to be executed at a certain priority level. 
The address of the scheduled coding can be either in the scheduling program, 
external to it, or in the system. 

If the desired priority of the scheduled program is higher than the running priority 
of the scheduling program, a pseudo interrupt occurs and the scheduled program 
is executed immediately, hi this way a schedule request can be considered a 
jump that also changes the running priority. Control will return to the "inter- 
rupted" program when the scheduled program exits. 

If the desired priority of the scheduled program is not higher, it is threaded onto 
a queue of programs waiting to be executed, in order of priority. In this way one 
program may schedule another to be executed at a different priority after the 
scheduling program exits. 

Background programs can be scheduled to run at levels 0 and 1 only. 

A parameter may be passed in the requestor’s Q regis ter to the program being 
scheduled. 

8. 3. 3. 1 Format of Schedule Request 

REQ RTJ- ($F4) 


15 

14 





9 

8 

7 



4 

3 


0 

0 

0 

0 

1 

0 

0 

1 

X 

0 

0 

0 

0 


P 



c 

Completion Address 


rc request code, 6 bits: 9 
X relative/indirect indicator, 1 bit: 0 or 1 
rp this field is ignored by the scheduler 
p priority, 4 bits: 0-15 
c address of program scheduled 

The macro call is: 

REQ SCHDLE c,p,x 

REQ will be on the 54F4, which will be generated by the macro. REQ+1 is the 
first word of the parameter strings 
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8. 3.3.1 


An example of a coded call would be: 

RTJ- ($F4) 

NUM $1201 

ADC PGM 

(schedules PGM at priority 1) 

8. 3. 3. 2 Request Code 

This field is always 9 for schedule requests, 

8, 3, 3. 3 XBit 

The X bit is used in conjunction with the c parameter. It will be discussed as it 
relates to this parameter. 

8. 3. 3. 4 Priority 

The p field is the priority at which the programmer desires to run the scheduled 
program. The priority may be greater than, equal to or less than the program 
that schedules it. However, in the background it is always 0 or 1. 

8. 3. 3. 5 Address 

The c field contains the address of the program being scheduled. The x parame- 
ter determines the forms the c may take as it did for the c parameter of the 
read/write requests. 

X ^ 

0 or blank c 


^0 c 

T^blank 


(c) 


The meaning of c 
c is the address, 
i.e., SCHDLE PGM, - 

PGM is assembled as an absolute address (pro- 
gram relocatable). 

c is relative. 

c is a positive increment added to the address 
of the first word of the parameter list to locate 
the address. 

i.e., SCHDLE PGM-*+l,-,X 
In this example PGM is the address. 

c is an index to the system directory. The ( ) 
set bit 15. X has no meaning. 
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8. 3.3. 5 


Note that there is no indirect form and that the option (c) cannot be used in the 
background because programs in the system library may not be scheduled from 
the background; see Chapter 11. 

8. 3. 3. 6 Example of Schedule Request 

The following example program writes one message from program SCHEDULE 
and then schedules TWO (the entry point in program NEXT) to run at priority 1 
and write another message. 
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8.3.3. 6 




0001 

0002 

0003 


NAM 

ENT 

EXT 


SCHEDULE 

XA 

TWO 


0004 

POOOO 

4558 


MA 

ALF EXAMPLE NO 1. * 


POOOl 

414D 





P0002 

504C 





P0003 

4520 





P0004 

4E4F 





P0005 

2031 





P0006 

2E20 




0005 




XA 

FWRITE 4, XB, MA, 6, A, 0, 1, A 

0005 

P0007 

54F4 




0005 

P0008 

OCOl 




0005 

P0009 

0010 

P 




POOOA 

0000 




0005 

POOOB 

1004 




0005 

POOOC 

0006 





POOOD 

0000 

P 



0006 





EXIT 

0006 

POOOE 

54F4 




0006 

POOOF 

OAOO 




0007 




XB 

SCHDLE TWO, 1 

0007 

POOlO 

54F4 




0007 

POOH 

1201 




0007 

P0012 

7FFF X 



0008 





EXIT 

0008 

P0013 

54F4 




0008 

POOH 

OAOO 




0009 





END XC 

I 


OOFF 


XA 

0007P MA OOOOP XB OOlOP 

0001 





NAM NEXT 

0002 





ENT TWO 

0003 

POOOO 

4558 


MB 

ALF *, EXAMPLE NO. 2* 


POOOl 

414D 





P0002 

504C 





P0003 

4520 





P0004 

4E4F 





P0005 

2E20 





P0006 

3220 




0004 




TWO 

FWRITE 4, XC, MB, 7, A, 0,1 

0004 

P0007 

54F4 




0004 

P0008 

OCOl 




0004 

POOOO 

0010 

P 




POOOA 

0000 




0004 

POOOB 

1004 




0004 

POOOC 

0007 





POOOD 

0000 

P 




0005 


EXIT 


0012X 


1 ENTRY POINT TABLE- 

XA 2E2F TWO 2F44 



J 

*X 

EXAMPLE NO 1. 
EXAMPLE NO. 2 
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8.3.4 


8, 3, 4 TIMER Request - Request Code 8 

The timer request is available only under MSOS. 

A hardware timing device such as the 1573 timer is required for the timer request 
to work since there is no real time clock in the CPU. 

The timer request is a scheduled request where the program is scheduled after a 
predetermined time delay. The delay allowed will be from 1/60 second to 32,767 
minutes. 

Parameters c,p, and x are specified as for the SCHDLE request. However, instead 
of a parameter a time delay is specified inQ when the request is made. The delay 
is specified in multiples of the basic unit of the timing device. The timer passes 
the current contents of the core clock (E8) to the scheduled program in Q. 

Timer requests are stacked in the schedule request stack but are not threaded 
with them. Instead, they are threaded together on the basis of time until activa- 
tion. When the delay for a timer request has expired, a SCHDLE request is made 
by the system and the request is rethreaded into the SCHDLE thread. 

The timer request is normally made by protected programs but it can be made by 
jobs at levels 0 or 1. 

The timer was different under MSOS 1. 0. 

8. 3. 4. 1 Format for the [TIMER Request 



rc request code, 6 bits: 8 
X relative/indirect indicator, 1 bit: 0 or 1 
u type of xmits desired, 4 bits: 0 to 3 
p priority, 4 bits: 0-15 
c address of program to be scheduled 
Q number of imits desired: 1-32,767 
must also be in Q register 

The macro form for this request is: 

TIMER c,p,x, Q, u 




8. 3. 4.1 


An example of a coded call would be: 


LDQ 

=N$0005 

RTJ- 

($F4) 

NUM 

$1024 

ADC 

PGM 

NUM 

5 


(schedule PGM in 5 seconds to run at priority 4) 

8. 3. 4. 2 Request Code 

Request code is 8, 

8.3.4. 3 XBit 

The X bit is used in conjunction with the c parameter. It will be discussed as it 
relates to this parameter. 

8.3.4. 4 Units 

The type of units requested is specified based on the basic unit of the timing 
device. 

u 

0 basic units: 60/sec on 1573 

1 l/lO second 

2 seconds 

3 minutes 

The imits field is used in conjunction with the Q parameter to calculate the desired 
time delay and it controls the precision required in the timing. 

8.3.4. 5 Priority 

This is the priority at which the scheduled program is to run. It follows the same 
rules as in a schedule request. 

8.3.4. 6 Address 

The c field contains the address of the program being scheduled and it follows the 
same rules as for a schedule request. 

8. 3. 4. 7 Q parameter 

The Q parameter is the numbe r of the type of units desired; it must be in the Q 
register and the Q word of the request. 
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8.3. 4. 7 


For example, a timer request for 5 seconds could be either u=2 and Q=5, or u=l 
and 0=50. If u=2, the request will be on the seconds thread and will be scheduled 
in at least 5, but less than 6, seconds. If u=l, the request will be on the l/lO 
second thread and will be s cheduled in at least 5 seconds, but less than 5 l/lO 
seconds. This is how the desired timing precision can be achieved. 

8.3. 4. 8 Example of] TIMER Request 

Assume the basic unit of the system is 1/60 second. Schedule the program PGM 
using an absolute call, after 20 minutes has elapsed, to run at priority 6. 

ENQ 20 

TIMER PGM, 6, , 20, 3 

8. 3. 5 STATUS Request - Request Code 3 

This request is available to unprotected programs only. Foreground programs do 
not use the status request to obtain status. 

The status of a particular read/write request is obtained with the status request. 
The status of the request is returned in the A, Q, and I registers. 

The status request can be used to determine whether an I/O operation is complete, 
to examine the type of hardware to which the logical xmit is assigned, to check the 
dynamic status on the hardware, or to find out how far along the I/O is by checking 
the current buffer address. 




8. 3. 5. 1 Format of the STATUS Request 



rc request code, 6 bits: 3 
X relative/indirect indicator, 1 bit: 0 or 1 

2 logical unit, 10 bits; modified by a, same as for read/write requests 
a logical unit address indicator, 2 bits; same as for read/write requests 
Settings are: 

a = blank =00: is the logical unit number 

a = R = 01: £ is a signed increment (+1FF) 

a = I =10: g is a core address (0<g<3FF) 

ap address of parameter list of request 
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8. 3. 5.1 



The macro call is: 

STATUS C , ap, a, x 

An example of a coded call would be: 


RTJ- 

($F4) 

NUM 

$0600 

NUM 

0004 

ADC 

REQ+1 


(Obtain status of a request on logical unit 4; request address is REQ+1) 

8. 3, 5. 2 Request Code 

The request code is 3. 

8. 3. 5.3 XBit 

The X bit is used in conjimction with the ap parameter and will be discussed as it 
relates to that parameter. 

8. 3. 5. 4 A Field 

The a bits modify the logical unit field in the same way as in the l/O request. 

8. 3. 5. 5 Logical Unit 

The logical unit is the same logical unit upon which the l/O request was made 
(the one we wish to have the status of). The logical unit may be specified directly, 
indirectly or relatively, in the same way the logical unit was specified in the l/ O 
request. 

8. 3. 5. 6 Address of Parameter List 

The ap field is the address of the parameter list for the request for which status 
is desired. It can be specified directly, indirectly or relatively, in conjunction 
with the X bit. 

X ap Meaning of ap 

=0 or blank ap ap is the address of the first word of the para- 

meter list of the I/O request. 

i.e., STATUS -, REQ+1, 

REQ+1 is the parameter address. 

ap is relative. 

ap is a positive increment added to the address 
of the first word of the status request parameter 
list to obtain the address of the first word of an 
input/output request parameter list. 


/O ap 

/blank 
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8. 3. 5. 6 


X ap 


=0 (ap) 

=blank 


^0 (ap) 

^blank 


Meaning of ap 


i.e. , STATUS REQ+l-*+2, X 
REQ+1 is the parameter address. 



ap is indirect 

ap is the address of a location containing the 
address of the first word of an input/output 
parameter list. 

i.e., STATUS (REQADR), - 
REQADR contains the address of REQ+1 


ap is double relative. 

ap is a positive increment added to the address 
of the first word of the status request parameter 
list to obtain the address of a location containing 
another positive increment. The second incre- 
ment is added to the address of the first word of 
the status request parameter list to obtain the 
address of the first word of an input/ output re- 
quest parameter list. Because of wraparound 
in adding, both increments may refer to loca- 
tions ahead of or behind the status request. 


i.e., STATUS -, (REQREL-*+2), -, X 
REQREL contains a number to be added to the 
first word of the status parameter list to form 
the distance to REQ+1 (s+l+contents of REQREL). 


Although the parameter/ address is not needed in the utility system, it is supplied 
to be compatible with 1700 MSOS. If it is omitted, only device status will be re- 
turned. 


8. 3. 5. 7 Reply to STATUS Request 

Following execution of the status request, the A, Q, and I registers contain the 
status. The content of these registers is as follows: 

A: hardware status of device 
Q: word 8 of Physical Device Table for device 
I: last core address of data transmission 
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8.3. 5.7.1 


8. 3. 5. 7, 1 Hardware Status 


A 


Hardware Status Reply 


The hardware reply is dynamic unless the device is connected to a buffered data 
channel and the channel is busy. If it is not busy, the hardware reply is the status 
obtained at the completion of the last request for that device. For an explanation 
of hardware replies refer to the hardware specifications. 

This status is the hardware reply bits on the device itself. 


8.3. 5.7.2 Word 8 of PDT 


See appendix D of the MSOS Reference Manual for contents of this word. 

15 14 13 11 10 4 3 1 0 


E 

S 

T 

R 

p| 


Word 8 EREQST 

Request Status 


P 

R 

T 

S 

E 


Bits 

0=1 
1 = 1 
2 = 1 
3 = 1 
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14= 1 
15= 1 


= 0 


Device not available to unprotected programs 
Device may be read from unprotected programs 
Device may be written by unprotected programs 
Equipment table includes words 18-33 for message 
buffering 

Equipment type constant (T), see T table 

Equipment Class, see S table 

Device failure 
Operation is in progress 
Operation is complete 

S TABLE 


EQUIPMENT CLASS CODES 
Word 8, EREQST Bits 11-13 

0 Class not defined 

1 Magnetic tape device 

2 Mass storage device 

3 Card device 

4 Paper tape device 

5 Printer device 

6 Teletype device 

7 Reserved for future use 


8-45 





8 . 3 . 5 . 7.2 


T TABLE 


0 

1 

2 

;i 

5 

6 

7 

8 
9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 
21 
22 

23 

24 

25 

26 

27 

28 

29 

30 

31 

32 

33 

34 

35 

36 

37 

38 ] 

39 j 

40 

41 

42 

43 ] 

44 J 
45-99 
100-127 


STANDARD EQUIPMENT TYPE CODES 
Word 8, EREQST Bits 4-10 

1711/1713 Teletypewriter 
1721/1722 Paper Tape Reader 
1723/1724 Paper Tape Punch 

Unassigned 

1738/853 Disk Unit 

1751 Drum Unit 

1729 Card Reader 

1738/854 Disk Unit 

601 Magnetic Tape Unit 

Software Buffering Device 

1742 Line Printer 

1728/430 Card Reader/ Punch 

Software Core Allocator 

210 CRT Display Station 

1558 Latching Relay Output 

1553 External Register Output 

311B/312B Data Set Terminal 

322/323 Teletype Terminal 

Unassigned 

166 Line Printer 

1612 Line Printer 

415 Card Punch 

405 Card Reader 

608 Magnetic Tape Unit 

609 Magnetic Tape Unit 
1713 Teletype Keyboard 
1713 TTY Paper Tape Punch 
1713 TTY Paper Tape Reader 
Unassigned 

1797 Buffered l/O Interface 
Software Dummy Alternate 
1584 Selectric l/O Typer 
1582 Flexowriter l/O Typer 
1716 Coupling Data Channel 
1718 Satellite Coupler 
Unassigned 

8000 Series Magnetic Tape Unit 
Unassigned 

1530 A/D Converter 30/40 PPS 
1534 A/D Converter 200 PPS 
1538 A/D Converter High Speed 

Unassigned 

Reserved for future standard equipment 
Open for user assignment 


8-46 



8. 3. 5. 7. 2 


The word 8 status can be used to determine several things about the device. The 
E field can be used to see if any request is active on the device and whether a 
hardware error is present; this requires operator intervention. T can be used to 
find out what kind of equipment the device is. For example, a program could see 
if the standard output device is a teletypewriter or a line printer and then output 
either 70-character lines or 136-character lines. The P and R fields can be used 
to determine the availability to jobs. 

8. 3. 5. 7, 3 Current Buffer Address 

I address 

The address of the last word that was stored in the buffer or written from the 
buffer is in the I register. In this way a job can determine how much of its buffer 
has been filled during operation. 


8. 3. 5. 8 Example of Status Request 


0015 



AA 

FWRITE 

0015 

P008F 

54F4 



0015 

P0090 

OCOl 



0015 

P0091 

OOAl 

P 



P0092 

0000 



0015 

P0093 

18FC 



0015 

P0094 

8053 

P 



P0095 

8052 

P 





XA 

EXIT 

0022 



OUT 

SQP 

0022 

P009C 

54F4 


STATUS 

0022 

P009D 

0600 



0022 

P009E 

80FC 




$FC,XA, (ADDR), (LENGTH), A, 0, 1, 1 


OK-*-l 

$FC,AA+1,I 


OK 


EXIT 


The above example takes status on the request from the completion routine if an 
error indication is present. 

More examples of status requests are in the CKASSM routine, section 8, 3. 10, 

8, 3. 6 GTFILE Request - Request Code 13 

This request is available only to background programs and only under MSOS. 

A permanent file that has been placed in the program library* can be accessed 
during execution by the GTFILE request. A file is brought into core as it appears 
on the mass storage device; GTFILE does not load a program. Ifaprogramis 

*A file is placed in the program library by a LIBEDT operation. 
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8.3.6 


placed in the program library as a file, it must be in its absolute binary form 
Data files cannot be changed and written back on the library during execution 
GTFILE only reads the file into core. 

8. 3. 6. 1 Format of GTFILE Request 



rc 

X 

rp 

cp 

c 

thread 

V 

m 

a 

£ 

wl 

s 

w2 

f 


request code, 6 bits: 13 
relative indicator 

request priority (for MSOS), 4 bits: 0 

completion priority, 4 bits: 1 

completion address 

for system: 0 

error bits, 3 bits 

mode, 1 bit: 0 * 

logical unit modifier, 2 bits: 2 * 

logical unit address of MS device, 9 bits: $C2 * 

first word desired in file 

starting core address for buffer 

last word desired in file 

filename address 


The macro call is: 

GTFILE c, f, s, wl, w2,x, rp, cp 


*Set by assembler if macro call used. 


8-48 




8. 3. 6.1 


An example of a coded call would be: 


FILNAM 


ALF 

*,FILE * 

i 

RTJ- 

($F4) 

NUM 

$1A01 

ADC 

GOT 

NUM 

0 

NUM 

$08C2 

NUM 

0 

ADC 

BUF 

NUM 

0 

ADC 

(FILNAM) 


FILE NAME 
COMPL 

BINARY, LIBUNIT 
WHOLE FILE WANTED 
BUFFER 

ADDR OF FILE NAME 


(The file FILE is requested to be stored in BUF. GOT is the completion address. ) 


8. 3. 6. 2 Request Code 

Request code is 13. 


8.3. 6.3 XBit 

The X bit is used in conjunction with the f parameter. It will be discussed as it 
relates to that parameter. 

8. 3. 6, 4 Request Priority 

The request priority is always 0 in the background for jobs. It will be used as the 
request priority for the mass storage driver when it reads in the file. 

8. 3. 6. 5 Completion Priority 

The completion priority is always 1 in the background. 

8. 3. 6. 6 Completion Address 

c is for the completion address and takes the same form as for the read/write 
request. 

8.3. 6.7 Mode 

The mode field must be set to 0 (binary). 

8. 3. 6. 8 A Field 

The a bit, logical imit modifier, must be set to 2 (indirect). 

8. 3. 6. 9 Logical Unit 

The address of the library logical unit, $C2, must be set in this field. 
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8.3.6. 10 


8.3.6.10 Word Addresses: wl, w2 

wl and w2 are the beginning and ending word addresses (mass storage) within the 
file if word addressing is used and the disk word driver is present in the system. 

If only a portion of a file is wanted, the wl, w2 specifies the words wanted. They 
are specified directly. If the complete file is wanted, wl and w2 should be left 
blank. 

GTFILE -,-,-,10,45,-,- 
GTFILE — , 

hi the first example words 10 to 45 would be brought in. hi the second, the com- 
plete file would be brought in. 


8. 3. 6. 11 Starting Core Address 

s is the starting address of the block into which the file or a portion of the file is 
to be transferred, x determines the type of addressing mode s takes. 


X s 


s 


=0 (s) 

=blank 


^0 (s) 

T^blank 


Meaning of s 

s is the starting address; x has no meaning, 
e.g., GTFILE BUF, - 

s is indirect. 

s is the corelocation which contains the starting 
address of the block. 

e. g. , GTFILE -, -, (BUFADR), -, -, -, -, - 
hi this case BUFADR contains the address of 
the block. 

s is relative. 

s is a positive increment added to the first word 
of the parameter list to form the s tar ting ad- 
dress of the block. 

e. g. , GTFILE -, -, (BUF-*+5), -, -, X, -, - 
BUF is the buffer. 


8. 3. 6. 12 File Name Address 

The f parameter indicates the address of the first word of a three-word block 
that contains the ASCII name of the file. It takes two forms, f and (f). 

f is a positive increment to be added to the first word of the parameter list when 
it stands alone. 
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8.3.6.12 



For example: 



GTFILE NAME-*+7,-,-, - 

In this case NAME would contain the first two characters of the ASCII name and 
the relative distance to NAME would be assembled into the macro. 

(f) indicates f is the address of the three word block containing the ASCII name. 
For example: 

GTFILE (NAME), - 

hi this case the address of NAME is assembled into the macro. 

The system searches the program library for the file with the specified name. 

It is supposed to be necessary to specify two additional words at the end of the 
request in which the system will return the actual sector address of the file. 
This does not work, however, so we omit it. 

8. 3. 6. 13 Example of a GTFILE Request 

The following example uses a GTFILE request to obtain a file named SYSINI from 
the program library and store it into a buffer, beginning at $6000 (absolute ad- 
dress). 

It happens that in this example the GTFILE request is to obtain a file that is an 
absolute program and is to transfer control to it; but the GTFILE could simply 
have been used to input data to a buffer. 

The example shows how the GTFILE works and how it is assembled. 
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3.6.13 


EXAMPLE USING GTFILE REQUEST FOR SYSTEM INITIALIZER 


0001 




NAM 

GETSI 

0002 




ENT 

SI 

0003 

POOOO 

5359 

FILNAM 

ALF 

*, SYSINI*-- 


POOOl 

5349 





P0002 

4E49 




0004 

P0003 

5349 

BUF 

ALF 

*, SI IN* 


P0004 

2049 





P0005 

4E20 




0005 


6000 

SIADDR 

EQU 

SIADDR($6000) 

0006 

POOOO 

0000 

SI 

0 

0 

0007 



GETFIL 

GTFILE 

GOT, (FILNAM), SIADI 


0007 

0007 

0007 

0007 


0007 

0008 
0008 
0008 
0009 
0009 

0009 

0010 
0011 
0011 
0011 
0011 

0011 

0011 


Name of FILE in program library 


MSG Buffer for TTY 


File to go at $6000 


P0007 

P0008 

P0009 

POOOA 

POOOB 

POOOC 

POOOD 

POOOE 

POOOF 


54F4 
lAOl 
0014 P 
0000 
08C2 
0000 
6000 
0000 
8000 P 


Completion address 
after SYSINI is brought 
into core 


\ 


Address 
where 
file name 
is 



CP= 1 
RP= 0 

X bit = 0 (not blank) 

Disk address 
left blank; 
program li- 
brary will be 
searched 


POOlO 54F4 
POOH OAOO 

P0012 54F4 
P0013 OAOO 
P0014 017B 

P0015 54F4 
P0016 OCOl 
POOH OOIE P 
P0018 0000 
POOlO 18FC 
POOIA 0003 
POOIB 0003 P 


GOT 

SUN 


EXIT (wait for completion) 


EXIT (unnecessary) 


SQM NOGOOD 

FWRITE $FC,WROTE,BUF,3,A,0,1,I,0 


LUN 

(std comment 
device) 


t t t t t 


COMPL 
ADDR 


MSG 

BUF 


bit = 0 (not blank) 
indirect bit referring to $FC 
CP= 1 
RP= 0 
ASCII 
3 words 


0012 

0012 

POOIC 

54F4 


0012 

POOID 

OAOO 


0013 

POOIE 

0171 

WROTE 

0014 

POOIF 

ICED 


0015 

0015 

P0020 

54F4 

NOGOOD 

0015 

P0021 

OAOO 


0016 





EXIT 

Wait until Write is done 

SQM NOGOOD 

JMP* (GETFIL+6) ^ 

EXIT 


END SI 


Jump to beginning address of 
SYSINI which is $6000 
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This program may be reassembled for any system. Change the EQU for the desired 
high core address where the system initializer is to be placed. The system initializer 
should be stored in the program library under the file name SYSINI. It can then be called 
into core by typing on the TTY 

*SI 

SYSINI was made a file so it could be stored in high core. 
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8. 3. 7 LOADER Request - Request Code 7 

This request may be made only by background programs. 

The loader request enables the program to load programs during execution. A 
program is loaded beginning at the first word of unassigned, unprotected core. 
When loading, the loader resides in the upper part of unprotected core, wiping 
out COMMON if it was being used. 

The parameters for the loader request are in the A and Q registers. These 
parameters prescribe what type of load is to take place and from which logical 
imit. 


15 3 0 


A 


Cu 

1 t 



15 



0 

Q 

tna 


t type of loading operation; discussion follows 

fiu logical unit number of the input unit if a relocatable binary program is being 
loaded 

tna entry point, core address of the first of three sequential locations containing 
the entry point name 


X 

Function 

£u 

tna 

0 

Load relocatable binary programs 
from any unit 

input device 

ignored 

1 

Load from program library 
on library unit 

library unit 

ignored 

2 

Load program from library 
unit and execute immediately 

library unit 

location of 
program name 

3 

Produce memory map 

ignored 

ignored 

4 

Look up entry point name 

ignored 

location of 
entry point 
name 

5 

Same as t = 1 but no memory map 
printed 



6 

Search directory of core-resident 
entry points 

ignored 

ignored 

7 

Initialize data base 

ignored 

ignored 
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When the load is completed without an error, the A register contains the last 
transfer address given, as in normal loading. If an error terminated loading, A 
contains zero and the Q register contains the storage address of the input block 
processed by the loader at the time the error occurred. 

8. 3. 7. 1 Format of the LOADER Request 


RTJ- ($F4) 


15 

14 





9 

8 

0 

0 

0 

0 

0 

1 

1 

1 

0 

— 0 


The macro call would be: 

LOADER 

An example of a coded request would be: 

RTJ- ($F4) 

NUM $0E00 

See the core request for a program example using the loader request. 

8. 3. 8 CORE Request - Request Code 11 

The core request can be made only by background programs. 

The core request can expand or contract available unprotected core. For exam- 
ple, if during execution the high locations of one’s program are no longer needed, 
one could release these locations by a core request so that another program could 
be loaded into this area. 

The core request has two forms, depending on the contents of the A and Q regis- 
ters. If A and Q are zero, the core request asks for the current boundaries of 
unassigned unprotected core. When the request has been processed, the Q reg- 
ister contains the lower boundary-1 and the A register contains the upper 
boimdary+1. (The contents of A and Q are actually obtained from core locations 
$ED and $EC.) With this information the program can set new boundaries to 
available unprotected core. 

When A and Q are non-zero and a core request is made, the new boxmdaries are 
set according to the contents of A and Q. A contains the new upper boundary and 
Q the lower. Both boundaries must be within unprotected core and A must be 
larger than Q. 

The core request is supposed to return the actual lower and upper bounds of un- 
protected core, but since it currently returns the lower-1 and upper+1 (from $ED 
and $EC) we program it to allow for that. 
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8. 3. 8. 1 Format of Core Request 


RTJ- ($F4) 


15 

14 

rc 



9 

8 








0 

0 

0 

0 1 

0 

1 

1 

0 

0 

0 

0 

0 

0 

0 

0 

0 


The macro call would be: 

CORE 

The coded call would be: 

RTJ- ($F4) 

NUM $1600 

8, 3. 8. 2 Example of Core Request 

The following example program, LOADERC, makes a core request to obtain 
bounds. It then drops the lower boimd by 22]^g, Then it makes a loader request 
to load a relocatable binary program tape from logical unit 2. The program on 
the tape will begin to overlay the BSS block in LOADERC at address POOll. 
LOADERC receives the entry point address in A from the loader (from the end tna 
card of the loaded program) and stores it in the second word of the jump instruc- 
tion, where it can jump to the loaded program. 


0001 



NAM 

LOADERC 


0002 



EXT 

ENTRY 

Unpatched external 

0003 


0002 

EQU 

TAPEU(2) 


0004 

POOOO 

0846 XX 

CLR 

A,Q 


0005 



CORE 


Get core limits 

0005 

POOOl 

54F4 




0005 

P0002 

1600 




0006 

P0003 

ODDD 

INQ 

-$22 


0007 



CORE 


Set lower limit 

0007 

P0004 

54 F4 




0007 

P0005 

1600 




0008 

POOOO 

COOO 

LDA 

=XTAPEU 

Set up LUN 


P0007 

0002 




0009 

P0008 

0FC4 

ALS 

4 


0010 



LOADER 

Call loader 

0010 

P0009 

54 F4 




0010 

POOOA 

OEOO 




0011 

POOOB 

6802 

STA* 

XA+1 

Save entry point address 

0012 

POOOC 

1400 XA 

JMP+ 

** 

Jump to it 


POOOD 

0000 P 




0013 

POOOE 

OBOO 

NOP 



0014 



EXIT 



0014 

POOOF 

54F4 




0014 

POOlO 

OAOO 




0015 



ENT 

XX 


0016 

POOll 

0022 


BSS PT($22) 


0017 



END 

XX 
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The system recovery package was used to dump some of the program area be- 
ginning at POOOD inLOADERC. It shows that the new buffer of the loaded program 
exactly ove r lay ed the BSS in LOADERC; then the write request, beginning at 
P0009 in the new program, wrote out the confirming message. 

Use of the system to execute this job is covered in Chapter 9, but the example is 
included here so that it can be studied for later reference (since it applies to 
the core and loader requests). 
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00 


00 

00 

bO 

RE DUMP 


New program F was 
loaded at 2F3F. 


I 


F 

2F3F 



f2F3B 

2F48 

OBOO 

54F4 

RE DUMP < 2F4B 

0000 

1004 

AF47 

/2F5B 

1804 




Buffer PT began here at 2F3F but is now overlayed 
by message buffer. CORE wiped out PT buffer and 
set new lower limit at 2F3F. 


ANOTHER EXAMPLE 


r 






OAOO 414E 4F54 4845 

5220 

4558 

414D 

504C 

4520 

2F3F 54F4 OAOO 0179 
Buffer address in F 

54F4 

ODOl 

0009 

0000 

1004 


Write request at 
entry point of F 

0008 54F4 OCOl 

FFF3 7FEB 54F4 


2F51 

OAOO 


TTY PRINTOUT 


♦p 


J 

*L,8 

J 

*SR 

J 


*X 
E * 



Unpatched external ENTRY which was not needed so 
ignored. 


L, 02 FAILED 02 1 

ACTION j 

CU 

ANOTHER EXAMPLE ] 
ANOTHER EXAMPLE j 


Load F from paper tape reader. There is no *T on 
the end of the tape, hence the message and CU. 


Output from Program F 


RE 

*2F3B 

ERR 


RE 

*D2F3B,2F5B 


RE 


RE Dump Request 



8. 3.9 


8. 3. 9 INDIR Request - No Request Code 

This request can be used by foreground or background programs under MSOS only. 
It is not a separate request but is an indirect version of any other request. 

Any request can be used again without repeating the request by using the INDIR 
request, 

8. 3, 9. 1 Format of the INDIR Request 



RTJ- 

($F4) 


15 



0 

1 


ap 




Only in the INDIR request should bit 15 of the first word of the parameter list be 
set to 1. This tells the system that the word under the RTJ- ($F4) is not a 
parameter but is the address of the parameter list to be requested. 

The macro form is: 

INDIR (p) 

p is the address of the parameter list; it must be in parentheses. 

To code the call: 


RTJ- ($F4) 

ADC (REQ+1) 

(if the desired request parameters begin at REQ+1) 

8. 3. 9. 2 Example of the INDIR Request 

An example of the INDIR request would be one in which the request parameters 
could be stored in a buffer and an indirect request could cause them to be executed. 

The following example stores the buffer address for MESSAGE in the s field of a 
request at REQBUF (the number of words in n) and then executes the request at 
REQBUF. 

Note that by using the INDIR request, control returns beneath it after the request 
is initiated. If a jump had been made to REQBUF-1 (if a RTJ- ($F4) were there), 
control would return under the parameter string at REQBUF. This may not be 
the desired action. 


o 
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BUF 

ALF 

*, MESSAGE * 


LDA 

=XBUF 


STA* 

S 


ENA 

4 


STA* 

N 


INDIR 

(REQBUF) 


REQBUF 

NUM 

$0C01 

FWRITE 


ADC 

COMPL 



NUM 

0 



NUM 

$1004 

ASCII, TTY 

N 

NUM 

0 


S 

NUM 

0 



More examples of the INDIR request appear in the routine CKASSM in the next 
section, 8. 4. 


8. 4 PROBLEM 

The following program is a routine which can be used to check out the macro assembler. 
Study itcarefullyto see what it does. 

After studying the program as it is written, figure out what would happen if the two SQP 
instructions at P0007 and POOOD were SQN instead. 

Comprehension of the CKASSM routine should be considered a "final examination" on re- 
quests. Any points which are not thoroughly clear to the reader should be restudied 
carefully in the appropriate sections. A very good knowledge of these requests is re- 
quired before the student goes on to study Part II of the training manual. 
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0001 





NAM CKASSM 84758702 

0002 





DECK ID 84^58/02 JUNt 4* 1968 

0003 





VERIFICATION TEST FOR A007 MACRO ASSEMBLER 

000^ 





SPEC ID WthtK TO 84800300 

0005 





PROGRAMMING SYSTEMS* A/D SYSTEMS DIVISION* CDC 

0006 




a 

ASSEMBLE USING 1700 MACR0T“AS5EMBLER 

0007 





THIS PROGRAM IS A VERIFICATION FOR THE 

000b 





MACRO ASSEMBLER 

0009 





THIS IS ONE OF A SERIES OF TESTS THAT USES 

OOlo 





INUIRECI SYSIEm KtuuEblb un VARIOUS 

0011 




« 

COMBINATIONS OF (F) READ/ (F) WRITE REQUESTS. 

0012 





ENT CKASSM 

0013 

POOOO 

OBOO 


CKASSM 

NOP 

0014 

0014 

POOOl 

54F4 



INDIR (Fl+1) 

CTTO" 

0015 

P0002 

80C5 

~P~ 


INDIR (Wl+1) 

0015 

P0003 

54F4 




0015 

P0004 

80BC 

P 



0016 

0016 

P0005 

54F4 


INI 

INDIR (Tl+1) 

0016 

P0006 

dOB8 

P 


1 

0017 

P0007 

0161 



SQP 1 

0018 

P0008 

18FC 



JMP* INI 

0019 





INDIR (Rl+1) 


P0009 

54F4 




0019 

POOOA 

80AF 

P 



U02U 

0020 

POOOB 

54F4 


1N2 

INDIR (12^1) 

0020 

POOOC 

80AB 

■P" 



0021 

POOOD 

0161 



SQP 1 

0022 

POOOE 

18FC 



JMP* 1N2 

0023 





FWRITE $FC**BUF*25*B***I 

0ir2T 

POOOh 

54k 4 




0023 

POOlO 

OCOO 




0023 

POOH 

0000 





P0012 

0000 




O023 

P0013 

08FC 




0023 

P0014 

0019 





"pwrs" 

004A 

T" 



0024 





EXIT 

0024 

P0016 

54F4 




0024 

P0017 

OAOO 




0025 

■pinnrar 

"4E45" 



ALF 25*NEXT MESSAGE SHOULD INDICATE VER IP ICAT ION 


P0019 

5854 





PUOIA 

204U 





POOIB 

4553 





POOIC 

5341 





POOID 

4745 





POOIE 

2053 





POOIF 

484F 





■P0020 

554C 





P0021 

4420 



P002C 4E20 


P0022 

P0023 

494E 

4449 



P002D 2020 

P002E 2020 


POO 24' 
P0025 

4341 

5445 



P002F 2020 




POD30 2020 


P0026 

2056 





P0027 

4552 





P0028 

4946 





P0029 

4943 





P002A 

4154 





P002B 

494F 





8-61 



8.4 


0026 

P0031 

4D41 


MS61 

ALF 25fMACR0 ASSEMBLER ON 1700 


P0032 

4352 





P0033 

4F20 





P0034 

"5T5T 





P0035 

5345 





P0036 

4042 





P0037 

4C45 





P0038 

“S2F0“ 





P0039 

4F4E 





P003A 

2031 





P003B 

3730 





P003(T 

3020 





P003D 

4F4B 





P003F 

2020 





P003F 

2020 





P0040 

2020 





P0041 

2020 





P0042 

2020 





P0043 

2020 





P0044 

2020 





P0045 

2020 





P0046 

2020 





P0047 

2020 





P0048 

2020 





P0049 

2020 




0027 

P004A 

0060 



B7S BUr(96) 

0028 




T2 

STATUS 5,R1+1 

0 0 28 

HUO AA 

bA-l- 4 




0028 

POOAB 

0600 




0028 

POOAC 

0005 




0028 

POOAD 

OOAF 

P 



0029 

POOAE 

54F4 


PI 

■ FRETAD $C2» *BUP f 25»B» ^ » I 

0029" 

■pOOAh 

OB 00 




0029 

POOBO 

0000 





PUObl 

0000 




0029 

P00B2 

08C2 




0029 

“P00B3 

00T9' 





POOB4 

004A 

P 



' 0 0 3 O' 

■pOOBb 

0000 



nUm 0*1 


P00B6 

0001 




0031 

0031 

P00B7 

54F4 


T1 

STATUS 5*W1+1 

0 03T 

■POOBB 

0600 




0031 

P00B9 

0005 




0031 

0032 

"POOHA 

oapnc 

~P~ 

W1 

FWRITE $C2**MSG1*25*B***I 

0032 

POOBB 

54F4 




0032 

POOBC 

OCOO 




0032 

POOBO 

0000 





POOBE 

0000 




0032 

PUUBh 

O'BU’B 




0032 

POOCO 

0019 





POOCl 

0031 




0033 

P00C2 

0000 



NUM 0*1 


P00C3 onm 
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8.4 



0 0 34 


FI 

FWRITE 5FC» f MSG»25 vA» , » I 

0 0 34 

PO 0C4 



0034 

P00C5 

OCOO 


0 0 34 

P00C6 

0000 



P00C7 

0000 


0034 

P00C8 

18FC 


0034 

P00C9 

0019 



POOCA 

0018 P 


0 0 35 



END CKASSM 



J 

*p 


J 

*ASSEM 
OPTIONS LX 
J 

*p 

J 

*L, 5 
J 

*X,N 

NEXT MESSAGE SHOULD INDICATE VERIFICATION 
MACRO ASSEMBLER ON 1700 OK 
J / 


o 
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9.1 


9. 1 JOB PROCESSOR 

The job processor is that part of the operating system which monitors the background. 
It is a system program, and it allows jobs to run in the background when the system does 
not need the CPU or the background core area. Under the control of the job processor 
are the program library and such jobs as assembling, loading, compiling and executing. 

The job processor resides in the system library on the mass storage device until it is 
called into execution by a manual interrupt and an * followed by any control statement and 
a carriage return (CR). 

For example; The operator depresses the MI key and types *P. 


MI 



J 


The system will type the MI and J. (hi this chapter all messages typed by the operator 
will be circled. ) MI indicates that the manual interrupt has been accepted. 

The Jwill be printed when the job processor has come into core and is ready for a control 
statement. The job processor types its messages on the standard comments device which, 
in most cases, is the teletypewriter. 

Each control statement to the job processor must begin with an asterisk and must be 
terminated with a carriage return. The job processor will t3^e a J when it has finished 
doing what it was instructed to do and is ready to accept another control statement. It 
will also light the BREAK light on the teletype, and the operator must depress the BREAK 
RELEASE key to turn off the light (and start the motor), then type his statement. If this 
light was not lighted, the system is not waiting for his input. 

If the operator realizes that he has typed the statement incorrectly before he types the 
carriage return, he can "erase" it by typing a rub out, line feed, carriage return and 
then proceed. 

JOX, hhhh indicates an error in a control statement to the job processor or a processing 
error in the background program. A summary of the error messages appears in Ap- 
pendix D. 

The following control statements are available for the operator to use to instruct the job 
processor in running a job. A brief description of their meaning is here and they are 
described in detail in the MSOS reference manual. 
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Figure 17. Control Statements Available Under the Job Processor 
Control Statement 

*p 

*K, lu, Pu, Lu 

*L, u 
*X, m 

* gentry point> 


*z 

If a job is in process, terminates the job. Fol- 
lowing a J, terminates job processor. 

*v 

Switches to standard input unit for subsequent 
control statements 

*u 

Returns control to comments unit for subsequent 
statements, (i. e. , This statement could appear 
on the card reader. ) 


Brings in the breakpoint package. 

*SR 

Brings in the system recovery package. 

*R,u 

Restores a logical unit u after it has failed. 


Terminates loading from input device. Should 
be last record of object deck being loaded. 

* 

Continue execution. 



Meaning 

Brings in the loader, initializes for an inde- 
pendent loading operation. 

Alters standard logical units. Where I is input, 
P is punch and L is the list device. 

Loads a program from logical unit u. 

Executes the program that was loaded. If m is 
blank, the memory map will be printed. 

Loads a program from the program library and 
transfers control to it. 


9. 1. 1 Assembling a Program 

Once an Assembly Language program has been written and placed in machine 
readable form (punched on a card, typed in USASI font for the OCR or punched on 
paper tape), it may be assembled by bringing in the assembler (*ASSEM(CR)) 
under the job processor's control. The *ASSEM(CR) statement assumes that the 
source deck will be read from the standard input device. For example, if the 
standard input device is the card reader, the programmer could place his cards 
in the hopper, depress the clear button and, at the telet 3 ^ewriter, bring in the 
job processor and assembler in the manner described on the following page. 
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Input Cards 


Comments Device 


/MON 

/end go 


/ENT GO 
NAM EXAMPL 


MI 

(Jp) 


(JASSEIV^ 

J 


The *P brings in the job processor and the loader to load the assembler. As- 
sembly will begin immediately and will continue until a MON card or an illegal 
assembly card is encountered. 

In this case an OPT card was not used; therefore, a listing will be made, an 
object program will be prepared on the standard output device and the relocatable 
binary program will be stored on the first scratch sector of the mass storage 
device for immediate loading and execution. This binary image of the object 
program on mass storage is called "load-and-go" (LGO). 

If an OPT card is used, the operator will have a choice of three results: listing, 
punching an object program and "load-and-go". The computer will type OPTIONS. 


Input 


Comments Device 


MON 


END GO 


/ent go 

I^NAM EXAMPL 
fOPT 


J 

(*p) 

J 

(*ASSE^ 

OPTIONS 


The operator's response can be: L if he wants a listing; P if he requires an object 
program; and X if he wants the "load-and-go" eXecute option. In the situation 
where a programmer is debugging and wants a listing plus the "load-and-go" op- 
tion to allow an immediate load from the mass storage device, he would type the 
following: 


(*D 

J 

(*assem) _ 

OPTIONS (X^ 
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The X, L and P can be in any combination and in any order; e. g. , LX or just P. 

If more than one program is assembled in the same run and each has an OPT card, 
the assembler will ask for new options when it assembles each subsequent pro- 
gram. 


Input 

rMON 

/END 

/nam 

OPT 

/END ~ 

r' NAM 
f/QPT 

/end 

/NAM 

I^OPT 

Assembling a Program, Illustration 1 


Comments 


(Jassem) 

OPTIONS 
OPTIONS O^p; 
OPTIONS rXP^ 

J 


Col. 

1 

Col. 

2 

Col. 

3 

Source 

Program 



0001 




NAM 

EXAMPL 

0002 




ENT 

GO 

0003 

POOOO 

4558 

MESSAG 

ALF 

*, EXAMPLE PRINT OUT* 


POOOl 

414D 





P0002 

504C 





P0003 

4520 





P0004 

5052 





P0005 

494E 





P0006 

5420 





P0007 

4F55 





P0008 

5420 




0004 



GO 

FWRITE $FC, GOl, MESSAGE, 9, A, 0, 1, 1, 0 

0004 

P0009 

54F4 




0004 

POOOA 

OCOl 




0004 

POOOB 

0012 P 





POOOC 

0000 




0004 

POOOD 

18FC 




0004 

POOOE 

0009 





POOOF 

0000 P 




0005 




EXIT 


0005 

POOlO 

54F4 




0005 

POOH 

OAOO 




0006 

P0012 

0806 

GOl 

SET 

Q,A 

0007 




END 

GO 

I 


OOFF 

GO 

0009P 

MESSAG OOOOP GOl 0012P 

Column one is the card number, e. g. 

, the symbol GO is on card four (4). Column 

two. 

when preceded by a P, 

is the address of each storage word relative to the 


beginning of the program. For example: the EXIT request takes up words 1O]^0 
and lli6« 
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The complete program occupies 13^0 locations (0000-0012). Note that the ENT 
card doesn’t occupy a location in the program nor does the END card. 


Column 3 shows the assembled code. For example, the first word of MESSAG 
assembles as 4558i0 which is the ASCII code for the letters EX. SET Q,A in 
machine language is O 8 O 6 i 0 . If a letter follows the machine code, for example P, 
the contents of the word is to be modified at load time. In the previous example, 
the word will be modified by the program counter, e. g. , If the program is loaded 
at location 2 OOOjl ^0 then the contents, after loading, of word OOOB 20 would be 
2 OOO 10 + 0012 ;|^g or 201210 . 

Everything to the right of Column 3 is a printout of the source deck as it appeared 
on input. 

Assembling a Program, Illustration 2 


Col. 

1 

Col. 

2 

Col. Source 
3 Deck 



0001 



NAM 

PSEUDO EX 

0002 


0010 

EQU 

CAT(16) 

0003 


0000 D 

DAT 

BUF(50),EX(50) 



0032 D 



0004 


0000 C 

COM 

TABLE(50) 

0005 

POOOO 

OOOA 

BSS 

XX(10),X,Y, Z 


POOOA 

0001 




POOOB 

0001 




POOOC 

0001 



0006 


0032 D 

ORG 

EX 

0007 

D0032 

C400 

LDA 

TABLE 


D0033 

0000 C 



0008 

D0034 

FOFO 

NUM 

$F0F0,$FFFF 


D0035 

FFFF 



0009 

D0036 

0000 D 

ADC 

BUF 

0010 


0000 P 

ORG 

XX 

0011 

POOOO 

5341 

ALF 

*,SAM IS OK* 


POOOl 

4D20 




P0002 

4953 




P0003 

204F 




P0004 

4B20 



0012 


OOOD P 

ORG* 


0013 

POOOD 

OBOO 

NOP 


0014 

POOOE 

OBOO 

NOP 


0015 

POOOF 

0000 

VFD 

X4/CAT 

0016 

POOlO 

OBOO QQ 

NOP 


0017 

POOH 

OBOO 

NOP 


0018 



EXIT 


0018 

P0012 

54F4 



0018 

P0013 

OAOO 



0019 



ENT 

QQ 

0020 



END 

QQ 
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In this example a D appears in column two - specifying the DATA area of storage. 
Thus, location 0032 of the DATA area will contain 0400^6 when loaded. 

The D and C following the machine instructions in column three indicate that these 
instructions will be modified by either the DATA counter or the COMMON counter. 
An X appearing in this position indicates an address external to the program. The 
COMMON and DATA counters are used by the loader when it is loading into these 
core areas. 


9. 1. 2 Loading and Executing a Program 

The general form for the -load statement is *L,u(CR). The u is for the logical 
unit of device from which the object deck is to be loaded. The program is loaded 
immediately but is not placed into execution until the *X(CR) statement is given. 
If a "load-and-go" option was chosen at assembly time, we could load and execute 
the program in the following manner (given that the scratch unit is logical unit 8): 


Input 


f MON 
END GO 



f NAM EXAM PL 
|"0PT 


Comments Notes 

Device 

J 

J 

(Jassem) 

OPTIONS (X^ 

J 

(HD 

J 

(*x) Execute the Program 

EXAMPLE PRINT Output from the program 

J 


The following is printed on the standard list device as a result of the *L,8(CR) 
(program name and address where loaded): 

List Device 

EXAMPL 24E0 

and as a result of the *X 

List Device 

ENTRY POINT TABLE (MAP) 

GO 24E9 
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Note that it was necessary to call in the loader with a *P control statement before 
asking the loader to load with the *L statement. After the loader loaded the pro- 
gram, the printout EXAMPL 24E0 indicated that the absolute beginning core 
address where the program was loaded was $24E0. 

If one has an object deck to be loaded from another device (other than the scratch 
LGO device), the same sequence would take place but this time the other logical 
unit would be used. This would be, for example, an object tape made earlier 
being loaded. An *T(CR) must follow the last program to be loaded. 

There are two forms to the *X(CR) statement. If a nonblank character is used 
after the X (i. e. , X, N(CR)), the memory map (Entry Point Table) will not be 
printed. 

Input Comments List Device 

Device 

J 


JOS, *A 
J 

J 

( *L^ 

J EXAMPL 24E0 

( *xTn) 

EXAMPLE PRINTOUT 
J 

Note that when an error on a control statement is made the job processor indi- 
cates the type of error, 03, that was made and prints out that error. In the above 
example, *A was an illegal control statement. 

9. 1. 3 Other Job Processor Control Statements 
*K Control Statement 

There are times when the programmer would like to change the various standard 
units. He may prefer that his listing appear on the teletypewriter or be stored 
on another output device to be printed at a later time. The programmer may 
change any standard device except the comments device by the *K, lu, Pu, Lu(CR). 
The I is for the input device with the u standing for the logical unit it is to be 
changed to. P is for the punch (or binary output) device and the L stands for the 
list (or print) device. For example, if the programmer wanted to store his re- 
locatable binary program on magnetic tape (logical unit 5 at his installation), his 
listing to appear on the comments device (logical unit 4), and his source program 
is on another magnetic tape drive (logical unit 6), he could type the following: 




9-7 



9.1.3 


Comments 

Device 

J 

(fK, P5,L4,ie) 

J 

*ASSEM 
OPTIONS (XL^ 

J 

The parameters P, L, I can be in any order and in any combination. The change 
will be in effect until another *K statement is given or until the system is auto- 
loaded again. It simply causes the contents of location $F9-$FD to be changed 
in core. 

It is usually a good idea for the programmer to r efe r to standard devices in his 
program rather than directly to specific logical unit numbers. Then he can re- 
assign the units with the *K control statement if he desires. Particularly, for 
example, if he was outputting answers on the printer, he could output on the 
standard print device. Then if the printer was down, the output could be changed 
to go on the teletype without changing the program. 

A standard device is also used by the system when a particular function is to take 
place but the logical unit number of the particular device to be used may be dif- 
ferent for each installation. For example, a message is to be given to the operator 
but whether the teletype is logical unit 4 or 11, or whether the message is to be 
printed on a line printer or upon an auxiliary teletypewriter depends upon the 
purpose and configuration. The actual device to be used can be defined by the 
logical unit placed in the LOCORE word associated with the standard device. The 
logical units are assigned at installation time but may always be changed by a *K 
control statement. 

*V and *U 

The *V is used to direct the system to expect further control statements from the 
standard input device. The *U (on the input device) tells the system to switch back 
to the comments device for control statements. 

Input Comments 

Device 

J K- U 
^ON 
sID GO 



EXAMPL 
SEM 


J 



J 
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These allow the programmer to put his control statements in the card deck rather 
than type them on the teletype. 

*<J]ntry Point Name> 

When a program has been placed on the program library either during system 
initialization or through LIBEDT it may be loaded into the system and brought into 
immediate execution by an * ^ntry point name> (CR) . The assembler and 
FORTRAN compiler work in this manner as do user written programs. 


Comments 

Device 


J 



J 


Call in PGM 
J 


The following is an example of compiling, loading and executing a program under 
FORTRAN. The TTY printout is shown. 
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1700 MSOS 2. 0 COMPILE AND EXECUTE 
Operator must first: STEP - center protect switch - master clear - autoload - run 


pp 

O 

MI 





options (^Pj^ 
^ I 


Set Protect Switch 
Manual Interrupt 

Assign Input to Card Reader 

Call in Loader 

Load FORTRAN 


I 


Source 

list 


PROGRAM NAME 
2 2 
CONTINUE 


L list source 
A list assembly 
P punch object tape 
X object on disk 


3 

3 



^ END 
0000 

0000 

NAM 

NAME 

0000 

1801 NAME 

JMP* 

.00001 

3 0001 

5400 . 00001 

RTJ+ 

Q8STP 

0002 

7FFF 



3 0000 

0000 

END 

( 


PROGRAM LENGTH $0003 

EXTERNALS 

Q8STP 


J 

^ 

J 



NAME 2066 
L,02 FAILED 02 
ACTION 

@) 

J 

@) 


Call in Loader 

• Load object from PTR 
■ Loaded at $2066 
- Reader out of tape 


Continue 


Execute 


Circled items are 
typed by operator 


Assembly list 


PSSTOP 2069 
Q8PAND 20A5 
I ENTRY POINT TABLE- 

NAME 2066 Q8STP 
Q8STPN 2087 


*X, , will eliminate MAP 


2080 
Q8COMI 208A 


Q8PSE 2069 
Q8PAND 20A5 


Q8PSEN 206E 


)* MAP 
MAP 


STOP 

J 


Finished. Run next job beginning with *P. 


REL BIN OBJ PT 
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The next example is one in which the control statements were on the input unit. In 
this case the card reader was used so the control statements were on cards with 
the source deck. TTY (comments device) printout and printer (list device) print- 
out are shown. 

TTY PRINTOUT CONTROL STATEMENTS ON INPUT UNIT 


MI 

*V Typed by operator, "Options" would also be typed by operator. 

E * Typed by operator. 

THIS PROGRAM WORKS ON THE 1700 COMPUTER SYSTEM UNDER MSOS 2.0 

J 

Program Printout 
(Formatted ASCII Write) 

Deck Setup: 

Operator must type *K (if needed to assign units), *V to send control to input imit. 


Deck would contain: 

(or *FTN) 

^ If OPT used, operator must type options 

LAPX, etc. 


etc. 

MON 

*p 

*L, 8 Load from LGO unit (i. e. , 8) 

*X,, 

If missing subroutines, operator must type *CR 

*U To return control to TTY 


*p 

*ASSEM 

NAM 


E] 
NAM 

IfD 


E 
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Printer Output 

Control Statements on Input Device 


p ^ — *p 

ASSEM-* — *ASSEM 



Deck 





0001 



NAM 

CARD TO PRINT 

0002 



ENT 

START, PRINT 

0003 



(EXT 

lOERR ) 


0004 


OOEA 

EQU 

ADISP($EA) 


0005 

POOOO 

0000 START 

0 

0 


0006 

POOOl 

54F4 

RTJ- 

($F4) 


0007 

P0002 

0201 

NUM 

$0201 

READ, CP=1 

0008 

P0003 

0009 P 

ADC 

COMPRD 


0009 

P0004 

0000 

NUM 

0, $100C 

THREAD, LUN CRf12, 


P0005 

lOOC 




0010 

P0006 

0028 

NUM 

40 

ONE CARD TO READ 

0011 

POO 07 

OOIF P 

ADC 

BUF 

FWA BUFFER AREA 

0012 

P0008 

14EA 

JMP- 

(ADISP) 


0013 

P0009 

0162 COMPRD 

SQP 

SCHPRT 


0014 

POOOA 

5400 X 

RTJ 

lOERR 



POOOB 

7FFF X 




0015 

POOOC 

54F4 SCHPRT 

RTJ- ($F4) 


0016 

POOOD 

1200 

NUM 

$1200 


0017 

POOOE 

0011 P 

ADC 

PRINT 


0018 

POOOF 

54F4 

RTJ- 

($F4) 


0019 

POOlO 

OAOO 

NUM 

$A00 

EXIT REQUEST 

0020 

POOH 

54F4 PRINT 

RTJ- 

($F4) 


0021 

P0012 

ocoi 

NUM 

$0C01 

PRINT, CP=1 

0022 

P0013 

OOIA P 

ADC 

COMPPR 

COMPLETION ADDRESS 

0023 

P0014 

0000 

NUM 

0, $1009,35 



P0015 

1009 





P0016 

0023 




0024 

POOH 

OOIF P 

ADC 

BUF 

FWA BUFFER 

0025 

P0018 

54F4 

RTJ- 

($F4) 


0026 

P0019 

OAOO 

NUM 

$A00 


0027 

POOIA 

0162 COMPPR 

SQP 

FINI 


0028 

POOIB 

5400 X 

RTJ 

lOERR 



POOIC 

OOOB X 




0029 

POOID 

54F4 FINI 

RTJ- 

($F4) 


0030 

POOIE 

OAOO 

NUM 

$0A00 

EXIT WHEN THRU 

0031 

POOIF 

0028 BUF 

BSS 

BUF(40) 


0032 



END 

START 


I 


OOFF START 

OOOOP 

PRINT 0011 P 

ADISP OOEA COMPRD 

SCHPRT 

OOOCP COMPPR 

OOIAP 

FINI OOIDP 

BUF OOIFP lOERR 




— 

,8 ^ — 

- *L 

CARD 2210 -4 — 

— Loaded at $2210 


— Execute 

ElO 


lOERR 

— Missing subroutine 


U 


ASCII 


0009P 

OOlCX 
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9.2 DEBUGGING 


After a program has been written, the programmer will want to run it to determine if 
the coding meets the specifications that he meant them to satisfy. There are basically 
two types of errors that may have been made: those of format and those of logic. The 
assembler and loader detect most of the format errors and notify the programmer via 
diagnostics. 


Two software packages are provided to help the programmer detect errors of logic: the 
breakpoint package and the system recovery package. 


9. 2. 1 Assembler Errors 

If an error is made in the general format of the program the assembler may detect 
it in either of the first two passes or in the third. If an error is detected during 
the first two passes, the diagnostic will appear before the NAM card on the listing; 
otherwise, the diagnostic will be within the body of the program. If at assembly 
time the L option was chosen, the diagnostics will appear on the list device; other- 
wise, the diagnostics will appear on the comments device. 

When the error is detected during the first or second pass of the assembler, the 
diagnostic will take the following form: 



Column 

1 

2-5 

6-7 

8-9 

10-19 

hi the following example a symbol to be 
be defined before it is used. Therefore, 
meaning undefined. The 0004 indicates 1 


Contents 

* 

4- digit card number 
2-character error code 

used in an IFA pseudo- instruction must 
the assembler prints the diagnostic UD, 
he error occurred in card #4. 
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LIST DEVICE 


*00 04 **UD* ********* 
*00 04 **UD* ********* 


0001 

0002 POOOO 5448 
POOOl 4953 
P0002 2057 
P0003 494C 
P0004 4C20 
P0005 414C 
P0006 5741 
P0007 5953 
P0008 2041 
POOOO 5353 
POOOA 4542 
POOOB 4C45 

0003 POOOC OBOO 

0004 XX 

0005 ZZ 


NAM VARIABLE ASSEMBLY 

ALE *, THIS WILL ALWAYS ASSEBLE* 


NOP 

IFA DOG, GT, CAT 

ALE *, SOMETIMES ASSEMBLES DEPENDING UPON CAT* 


When an error is discovered in the third pass of the assembler, the assembler 
will print the message immediately before the line with the error in the following 
form: 


sjof: Q p ^ ^ 

****** UJ) ********* * 

0006 P0006 0000 SHIFT TWO 

The PP in the first example says the error in that card was identified in the pre- 
vious pass. 

The next example shows the RL error messages for attempted illegal relocation 
outside the program area (relative). It also shows the EX message for the illegal 
expression in the address field of the VFD. 
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LIST DEVICE 



0001 



NAM 

PSEUDO EX 

0002 


0010 

EQU 

CAT(16) 

0003 


0000 D 

DAT 

BUF(50),EX(50) 



0032 D 



0004 


0000 C 

COM 

TABLE (50) 

0005 

POOOO 

OOOA 

BSS 

XX(10),X, Y, Z 


POOOA 

0001 




POOOB 

0001 




POOOC 

0001 



0006 


0032 D 

ORG 

EX 

0007 

D0032 

C400 

LDA 

TABLE 


D0033 

0000 C 



0008 

D0034 

FOFO 

NUM 

$F0F0,$FFFF 


D0035 

FFFF 



0009 

D0036 

0000 D 

ADC 

BUF 

0010 


0000 P 

ORG 

XX 

0011 

POOOO 

5341 

ALF 

*, SAM IS OK* 


POOOl 

4D20 




P0002 

4953 




P0003 

204F 




P0004 

4B20 



0012 


0000 P 

ORG* 


0013 

POOOD 

OBOO 

NOP 


0014 

POOOE 

OBOO 

NOP 





0015 POOOF 0000 ADDRESS ADC* 


POOlO 

0032 

POOH 

FFF8 

POOH 

FFF8 

P0013 

FFF8 

POO 14 

FFFA 


0016 P0015 5800 BYTE VFD 


BUF, EX, X, Y, Z, ADDRESS 


/ / / 

A8/X, B3/7 , B2/1, B8/$FF 


9. 2. 2 Device Failure 

If while working with the 1700 System there is a device failure, the operating 
system will print the following: 


L,nn Failed ee 
ACTION 

The nn specifies the logical unit that failed and the ee an error code indicating why 
it failed. 


o 
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Error Code 

Meaning 

00 

Input/ output hangup (diagnostic timer) 

01 

Reject (internal or external) 

02 

Alarm 

03 

Parity error 

04 

Checksum error 

05 

Internal reject 

06 

External reject 

special errors for each device 

see the manual for its driver. 

operator may respond in one of the following ways: 

RP 

Repeat the request. This assumes the 
operator has corrected the condition and 
wants to complete the operation. The 
operator may have forgotten to ready the 
device. Upon receiving a device failure 
message, he depresses the ready button, 
types RP and goes on as normal. 

CU 

Indicates the error has not been cor- 
rected but the operator would like to con- 
tinue operating. The program is notified 
of the error. 

DU 

The device is marked down for this re- 
quest and all future ones. This allows 
the operator to get back to the job pro- 
cessor and take the necessary steps to 
use another device for his program. 

CD 

The same as CU but, also, suspends job 
processing. 

DD 

The same as DU but, also, suspends job 


processing. 


In the example on the following page the load was from the paper tape reader. The 
paper tape was read past its end, as there was no *T(CR) on the end of the tape. 
The CU signalled the loader to continue as all the tapes had been read. 
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J 

*L,2 

L,02 FAILED 02 
ACTION 
CU 
J 


If it had been desired to load another tape, the operator would have put it in the 
reader and typed RP instead. 



J 

(Jassem) 

L, 02 FAILED 02 
ACTION 



J 

( *K, Lll, 113 ) 


J 



(Jassem) __ 

OPTIONS (xl) 
J 


hi this case the operator did not want to assemble from the standard device but 
forgot to change the logical unit before the *ASSEM statement. By marking the 
device down he got back to the job processor to change devices and continue. 

9. 2. 3 Loading Errors 

At the time of loading the loader may detect those types of errors that can only be 
detected at load time, such as undefined externals, DATA or COMMON declared 
larger by a second or third program than by the initiating program. The diag- 
nostics appear on the list device preceded by an E . 

9.2.4 Logic Errors (Detected During Execution) 

There are several standard software packages to help a programmer detect errors 
of logic. The Breakpoint Package and System Recovery Package aid in debugging 
programs in the background. UTOPIA and the On-line Debug Package are for de- 
bugging in the foreground in the real-time environment, hi this chapter the 
breakpoint package and system recovery package will be discussed. 
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The breakpoint package allows the programmer to do such things as run his pro- 
gram under different sets of trial data, divide his program into segments and 
execute only portions of his program at a time or check intermediate results as 
he goes along. The recovery package only functions after the program has aborted 
or finished normally. The programmer then can dump core or mass storage to 
determine the final state of his program and data. 

There are several reasons for using a debug package as compared to console de- 
bugging. One of the most important on the 1700 is that one can debug while the 
machine is being shared with other programs. It is also easier as several con- 
versions are made for the programmer and the programmer has a hard copy of 
his statements and results. 

9. 2. 4. 1 The Breakpoint Package 

The brealqDoint package must be brought in by an *B sometime after an *P and 
before the program is put into execution. However, the breakpoint control state- 
ments are not used until after the *X statement. All numerics in the brealqjoint 
package are in hexadecimal and all addresses are absolute core addresses not 
program addresses. A BP message from the computer indicates that the break- 
point package is in operation and expects a control statement. 

The *B control statement actually causes a flag to be set in the job processor so 
that after the *X control statement is typed the breakpoint package is brought into 
core and control is transferred to it. Therefore, the core area the breakpoint 
package runs in is physically the core area immediately above the area occupied 
by the background program. 
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Available to Breakpoint Package 


Figure 18. Control Statements 
Control Statement 
*Ahhhh(CR) 

+C(CR) 

*Daaaa , aaaa (CR) 

X ^ 

*Eaaaa, hhhh, .... (CR) 

*Ihhhh(CR) 

*Jaaaa(CR) 

*Msl, wl, s2, w2, n(CR) 

*P(CR) 

*Qhhhh(CR) 

*Raaaa(CR) 

*Saaaa, aaaa, .... (CR) 

*Taaaa, aaaa (CR) 

*T(CR) 

*Z(CR) 

For example: 


Brief Description 

Enter register A with the hexadecimal 
number indicated by the hhhh. 

Continue execution after breakpoint 
reached 

Dump locations from hexadecimal ad- 
dress aaaaj^ through aaaa 2 » 

Enter locations in core from hexadebi- 
mal address aaaa with data hhhh, hhhh,,.,. 

Enter Index I with the hexadecimal num- 
ber hhhh. 

Jump, that is transfer control, to the 
address given by the aaaa. 

Dump data from the mass storage device 
beginning with the sector and word, si, 
wl through the sector and word indicated 
by s2,w2. Logical unit n. 

Print the contents of A, Q, I, P and M. 

Enter the Q register with the hexadecimal 
number given by hhhh. 

Transfer control to and set a brealq)oint 
at location aaaa. 

Set breakpoints at locations indicated by 
the aaaa’s. Maximum of 15 set at one 
time. 

Terminate breakpoints at the locations 
specified by the aaaa's. 

Terminate all breakpoints that have been 
set. 

Terminates the breakpoint package. 


Comments Device 


Notes 


J 

(fASSEM"^ 

OPTIONS (X^ 
J 

(*k7l4) 

J 

© 

J 


PSEUDO 

PSEUDO 

E8 

QQ 

CLASSP 


2544 

255D 

255D 



Note error and overlay 


J 



1 ENTRY POINT TABLE- 
**»COM 7FCD 
***DAT 24E0 

QQ 2559 START 2587 

BP 
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At this point the programmer can enter any one of the available breakpoint state- 
ments. 

The programmer may want to break his programs into portions and execute them 
separately. An Saaaa, aaaa, . . . . CR sets a stop or breakpoint at the addresses 
, aaaa, so that during execution when the program reaches this point the program 
will halt and control will return to the keyboard. The breakpoint program will at 
that time print the message BP, aaaa indicating that the brealq)oint at the address 
aaaa has been reached and the breakpoint program expects another control state- 
ment. 


For example, in the program EXAMPL listed as illustration 1 under Section 9. 1. 1 
perhaps the programmer would like to execute his program thru the EXIT on card 
5, program location 12. He would probably take the TTY listing which has the 
address of the first location of his program (24E0). He would then add the pro- 
gram relocatable address of the instruction where he wants the breakpoint to the 
first location. He would set the breakpoint one instruction after the last instruc- 
tion that he wants executed. For example: 


Comments Device 


J 



J 


( 5 ^ 

EXAMPL 24E0 


J 



Notes 


24E 0 machine address of program 
+ 12 instruction in program 
24F2 actual address 


1 ENTRY POINT TABLE- 
GO 24E9 


BP 

^S24F2^ 

BP 

(Jd24E0,24F^ 

24E0 4558 414D 504C 4520 5052 

24EA OCOl 24F2 0000 18FC 0009 
BP 

(*J24E9) 

EXAMPLE PRINT OUT 
BP, 24F2 


494E 5420 4F55 5420 
24E0 54F4 OAOO 54F3 


54F4 
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The *S24F2 sets a breakpoint at 24F2. The D24E0,24F2 dumps that core area. 
The J24E9 jumps to location 24E9 (P0009) and executes the write. The program 
stops at 24F2 before executing the SET A, Q instruction. 

One can set a maximum of 15 breakpoints with one *Saaaa(CR). However, many 
more than that can actually be set at any one time. A breakpoint at a location is 
actually a RTJ to the breakpoint package inserted in place of the actual code. The 
actual code is kept by the breakpoint package to be executed and to be returned 
when the brealqDoint is removed. Therefore, several considerations should be 
made when setting a breakpoint. A breakpoint should not be set at a non- executable 
instruction such as a data word because the program would never get to that word 
to execute the RTJ, and therefore would not stop at that breakpoint. Also, the 
breakpoint should not be set at the second word of a two-word instruction because 
when that instruction is put into execution the RTJ would then be interpreted as an 
address rather than executed as a jump to the breakpoint package. The brealqDoint 
should not be placed at a location that will be modified or changed during execution. 
For example, a breakpoint should not be set at an instruction whose address is to 
be modified or the first word of a subroutine whose entry is via a RTJ for then 
again the RTJ to the breakpoint package would be modified or destroyed and the 
result would be unpredictable. 

A breakpoint should never be set on an RTJ instruction because the actual instruc- 
tion is executed in the breakpoint program itself. Hence, the actual program's 
RTJ would take the wrong address with it. 

If a breakpoint is to be cleared, the *Taaaa, aaaa(CR) statement is used. If all the 
brealq)oints that have been set are to be cleared, the *T(CR) statement is used but 
none of the addresses are specified. 

The contents of the registers are printed out with the *P(CR) statement. 


BP 



REG. A=18FD Q=18CD 1=0814 M=9000 P=54FF 

BP 

One can enter each of the registers except M by indicating the register and typing 
the hexadecimal number that is to be entered. 

BP 

(Jafofo) 

BP 

(*iffff) 

BP 

(*Q1234) 

BP 



REG. A=F0F0 Q=1234 I=FFFF M=9000 P=54FF 
BP 
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The contents of core can be dumped by the *Daaaa, aaaa statement. The first aaaa 
specifies the first location the programmer wants to print and the second aaaa 
specifies the last. 

BP 

*S24F2 

BP 

^D24E0,24F2} 


24E0 4558 

414D 

504C 

4520 

5052 

494E 

5420 

4F55 

5420 54F4 

24EA OCOl 

24F2 

0000 

18FC 

0009 

24E0 

54F4 

OAOO 

54F3 

BP 









The output from the 

*P(CR) 

statement is 

on the 

standard list device, 

, In this ex- 


ample the list device has been made the same as the comments device with an *K 
statement. This example is a dump of the program listed as Illustration 1. Note 
that the last location printed out (54F3) has been set as a breakpoint. 

If only one location is wanted, specify the single address. 


BP 


(JD24e6) 

24E0 

BP 


4558 


If one wants to enter a location in core an *Eaaaa, hhhh, hhhh, .... (CR) is used. 
The aaaa specifies the first address to be entered and the following hexadecimal 
numbers to be placed in each sequential location. 

BP 

(*E2557, FFFF, 0000, FFFI^ 

BP 

(Jd2557,255^ 

2557 FFFF 0000 FFFF 
BP 

( *EAAXX^ 

BOl, *EAAXX Note the error message 

BP 

*E2557, AAAA, BBBB, CCCC 

BP 

^D2557,255^ 

2557 AAAA BBBB CCCC 
BP 
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If a location is to be skipped, i. e. , not entered with data, skip that location by 
typing two commas in a row. This indicates that the location is to be left unaf- 
fected. If a location is to be filled with zeros, the zeros must be specified. 

When a programmer would like to begin execution of a sequence of programming 
out of the normal sequence, he may use' the jump statement, *Jaaaa(CR) to the 
instruction to be executed. Execution begins immediately after the *Jaaaa state- 
ment. The aaaa is the address of the first instruction to be executed. 


J 

( *K,1A) 


J 



EXAMPL 24E0 
J 



1 ENTRY POINT TABLE- 
GO 24E9 

BP 

(*S24F2) 

BP 

(*D24E0,24F2) 

24E0 4558 414D 504C 4520 5052 494E 5420 4F55 5420 54F4 

24EA OCOl 24F2 0000 18FC 0009 24E0 54F4 OAOO 54F3 

BP 

(*J24E9^ 

EXAMPLE PRINT OUT 
BP,24F2 


The *J24E9 caused the jump to P0009 to execute the write. 

The return jump *Raaaa is used when an iterative loop is being checked out and 
the programmer would like a stop at each execution of the loop. 

The contents of words on the mass storage device may be dumped using the 
*Msl, wl, s2, w2, nCR where: 

si is the beginning sector number 

wl is the beginning word to be dumped of that sector 

s2 is the last sector to be dumped 

w2 is the last word of that sector to be dumped 

n is the logical unit of the disk 
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There are several combinations that one can use. If, while working in the back- 
ground, the scratch unit is wanted, the n may be omitted and the scratch unit is 
assumed. If complete sectors are wanted, the word specification can be omitted 
and the complete sector will print. If one wanted to examine a file that has been 
stored on sector 24 of the disk, he could do the following: 

*M24(CR) 

The programmer may begin in the middle of a sector and dump the rest of the 
sector by specifying the first sector and first word but omitting the second sector 
and word. 



If the first complete sector of scratch is wanted, type 


*M(CR) 


Examples of the *M statement are under the system recovery section as the system 
recovery’s *M works exactly the same as the breakpoint's. 


If at any time the program is to be terminated, a MI and an *Z(CR) will do so. An 
example of *Z being used to terminate a job is in the first program in the system 
recovery section. 


If an error is made while using the breakpoint package, the breakpoint package 
will print a message beginning with a B. The possible error statements are as 
follows : 


BOl, statement 
B02, hhhh 
BOSjhhhh 
B04 


Statement or parameters are unintelli- 
gible for the breakpoint program. 

hhhhi 0 cannot be processed by break- 
point program because it is protected. 

Breakpoint limit exceeded. hhhh ]^0 is 
the last breakpoint processed. 

Previous *E statement requested entries 
in protected core. Entries are not pro- 
cessed; brealq)oint program waits for 
new statement. 


9. 2.4. 2 System Recovery Package 

The system recovery package is called in with an *SR(CR) before the program is 
executed just as the breakpoint was. However, the system recovery package does 
not function and does not accept control statements until after the program has 
finished normally or aborts. A RE message indicates that Recovery is in and is 
ready to receive a statement. 
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Figure 19. Control Statements Available to the System Recovery Package 


Control Statements 
*Daaaa-j^, aaaa2(CR) 


*Msl, wl, s2, w2, n(CR) 


*T(CR) 

*n(CR) 


Brief Description 

Dump locations of core beginning with hexadeci- 
mal address aaaai and ending with hexadecimal 
address aaaa2« 

Dump mass storage unitnfrom sector and word 
sljwl to sector and word s2,w2. 

Terminate the system recovery package and re- 
turn to the job processor. 

Change the list device for dumping contents of 
core or mass storage. 


The statements for dumping core and mass storage are the same as for the break- 
point. The output is on the standard list device. 


An *T(CR) terminates the system recovery package. 


J 



EXAMPL 24E0 


J 



1 ENTRY POINT TABLE- 


GO 24E9 

BP 

(*J24E9) 

EXAMPLE PRINT OUT 
BP. 24F2 
(Je24ED, 18F^ 

MI 

RE 

(Jd24E0,24F2^ 

24E0 4558 414D 5048 

24EA OCOl 24F2 0000 

RE 


Note that breakpoint and recovery flags may be 
set 


The operator presses the manual interrupt 
button on the typewriter here if he desires to 
terminate job execution and enter the Recovery 
package 

4520 5052 494E 5420 4F55 5420 54F4 
18FB 0009 24E0 54F4 OAOO 54F3 


The*D above dumps core from 24E0 through 24F2, after the program has executed. 


o 
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BP 

(*J24E9) 

EXAMPLE PRINT OUT 


RE 

(*4) 

RE 

ERR 


Note: 

ERROR Occurred because word 1 is larger than word 

2. 

RE 

SECTOR NUMBER 

0000 









0015 

5800 

0D03 

0302 

1803 

OBOO 

18F0 

5806 

0D04 

03FB 

5803 

OOIF 

0400 

1401 

0000 

0844 

E80D 

OBOO 

02FE 

A30B 

B80B 

0104 

0029 

OFOA 

0121 

18DF 

18F5 

C8E0 

1CF2 

0000 

0181 

0039 

0019 

0033 

♦♦ 

OBOO 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

RE 

C*D2137') 

2137 

C80D 










RE 

(*D24E0, 255^ 
24E0 

0001 

0163 

OAOO 

0001 

0002 

0003 

0004 

0005 

0006 

0007 

24EA 

0008 

0009 

OOOA 

OOOB 

OOOC 

OOOD 

OOOE 

OOOF 

0010 

0000 

24F4 

0000 

FFFE 

FFFA 

FFFC 

FFFB 

FFFA 

FFF9 

FFFF 

5443 

4520 

24FE 

534D 

414C 

4045 

5354 

204E 

4F2E 

2049 

5320 

4154 

204C 

2508 

4F43 

2E20 

0000 

24E3 

68D5 

0842 

481D 

0C17 

5825 

54F4 

2512 

ODOl 

0008 

0000 

18FC 

OOIE 

7FEA 

54F4 

OAOO 

54F4 

ODOl 

251C 

0008 

0000 

08FC 

0001 

255E 

54F4 

OAOO 

54F4 

ODOl 

0008 

2526 

0000 

18FE 

OOOA 

0031 

0000 

OBOO 

0000 

2560 

68B3 

0C09 

2530 

5805 

0000 

18FD 

68F7 

18DC 

OBOO 

CCAB 

68A8 

68A8 

D8A8 

253A 

ODFE 

0161 

1CF8 

90A4 

01A7 

0138 

CCAl 

689E 

C800 

FF9E 

2544 

681A 

18F3 

0131 

18F8 

CC99 

9897 

01A6 

012A 

CC95 

6893 

254E 

C893 

6810 

18E8 

0131 

18E6 

18F8 

5448 

4520 

534D 

414C 

2558 

4045 










RE 











(^*M, 124, 25, 124^ 

SECTOR NUMBER 

0000 









0124 

0814 










SECTOR NUMBER 

0001 









0001 

5803 

404F 

4144 

FFFF 

6804 

4804 

1800 

0003 

FFFF 

FFFF 

OOOB 

5800 

OODO 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0015 

0000 

0000 

0000 

0000 

5000 

0000 

0000 

0000 

0000 

0000 

OOIF 

:k:k 

2020 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

SECTOR NUMBER 

0002 









0001 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

2020 

2020 

OOOB 

2020 

0000 

0000 

0000 

0000 

1400 

FFFF 

FFFF 

FFFF 

FFFF 

RE 













Note: 

** implies that the 0000 

or FFFF continues for the rest of the 


J 
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In the previous example the *4 reassigns output to lun4, the TTY. The *M, 15 im- 
plies sector 0 of scratch from word 15 on. *D2137 dumps location 2137. 
*D24E0, 2558 dumps those locations, inclusive. *M, 124, 25, 124 dumps several 
consecutive sectors. 
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10.1 


CONFIGURING A SYSTEM 

The content of this chapter will be devoted to the 1700 and its peripherals as a total system. 
It is designed to assist the presales analyst in configuring a system by considering the inter- 
relationship of the various pieces of hardware. Each has its own characteristics which must 
relate to and interface with the total hardware configuration. 

Figure 20 is a diagram of most of the standard hardware and it should be consulted as a 
reference from the text in this chapter. Figure 21 also contains the hardware and it includes 
the new hardware. 

10.1 CENTRAL PROCESSOR 

The basic 1704 computer consists of the central processor, arithmetic unit, 4K memory 
and A/Q channel access to the low- speed l/O package via the slow- channel synchronizer, 
equipment number 1. 

Memory modules maybe added in 4K (1708) increments to a maximum of 32K. The 1709 
(8K module) is available only on a used basis. A new hardware addition has recently 
been made to the product line to allow an increase of memory size to 65K. 

Two interrupt lines are included: line 0 for internal interrupts and line 1 for the slow- 
channel synchronizer. 

10. 1. 1 Low Speed l/O Package 

The low- speed package consists of: 

• teletypewriter 

1711 - keyboard entry and printer only, 100 characters per second 

1712*- keyboard & printer, 100 cps, with offline mechanical paper tape 
reader and punch 

1713 - keyboard, printer, on-line mechanical paper tape reader and punch, 
100 cps 

• paper tape reader 

1721 - 400 cps reader, electronic 

1722 - same reader, with added take-up and supply reels 

• paper tape punch 

1723 - 120 cps punch 

1724 - same punch, with added take-up and supply reels 

• card reader 

1729*- 100 card-per- minute reader, replaced by 1729-2 which connects to 1705 
*Only available used on an as -available basis. 
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These are the standard peripherals connected to line 1; other peripherals must 
normally be connected through a 1705. Some existing configurations do have 
special peripherals other than those above on line 1, but this is on a QSE basis 
and each case must be considered individually. 

10.2 1705 INTERRUPT DATA CHANNEL 

Any system which will require more than the two basic interrupts or the peripherals in 
the low-speed l/O package will need a 1705. The addition of the 1705 will add the fol- 
lowing capabilities to the system: 

a) addition of 14 more interrupt lines for external equipment 

b) addition of up to eight controllers to the A/Q channel 

c) addition of direct memory access for up to eight buffered controllers 

See note A, Figure 20, for additional explanation of line connections. 

Input/Output for the additional eight controllers would be unbuffered if they are connected 
to the A/Q channel only. l/O will be buffered if they are connected to the A/Q channel 
and the DSA bus and are either capable of doing direct memory access on their own or 
are connected through a 1706 or 1716. 

10. 3 BUFFERED CONTROLLERS 

Three controllers are capable of performing data transfers directly between computer 
memory and the attached peripheral device: 

1738 disk controller - controls one or two 853 (1. 5-million-word) or 854 (3. 0-million- 
word) disks, 

1751 drum controller - controls drum; size from 65K to 524K words, 

1748 master communications terminal controller - controls up to 64 remote com- 
munications sets (through 8136’s) or up to four 302 communications expansion modules. 

The buffered controllers are connected to the A/Q channel (for transfer of control infor- 
mation) and the DSA bus (for transfer of data). Any program which is running and using 
the CPU continues to run while the controller is handling the data transfer, since the 
A and Q registers are not used during the data transfer. 

Direct memory transfer is done on a cycle- stealing basis; that is, the controller steals 
a memory cycle every time it wishes to transfer a word (through the Z register). In 
order to calculate how much each buffered controller wHlslow down the CPU (and, there- 
fore, a running program), a percentage could be figured based on the transfer rate of 
the peripheral. For example, the 1738 is capable of transferring one word every 12. 8 ps 
so it will steal approximately every 12th cycle and can therefore slow down a program 
by up to 9% when the disk is running. The program would only be slowed down if the 
CPU and the 1738 both wanted to access memory at the same time. 
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10.4 1706 BUFFERED DATA CHANNEL 

The 1706 allows direct memory access for unbuffered controllers. It is for any of the 
controllers that are not capable of doing buffered data transfers. (That is, any except the 
1738, 1751 and 1748.) The 1706 is connected between the 1705 (DSA and A/Q channels) 
and the peripheral controller. 

Only three I706's are allowed in any system; this is a software limitation rather than a 
hardware limitation. The 1716 is exactly like a 1706 except it is accessible by two 
computers. See note C of Figure 20. The 1706 may control up to eight controllers. 
However, when deciding which peripherals should go on the 1706, it is very important to 
note that it is logically busy the entire time it is handling a buffer transfer for a pe- 
ripheral. During that time it cannot be accessed to do any operation or take status on i 
any other peripheral connected to it. Therefore, the timing on the peripherals must bef 
considered so that data will not be lost on one while the 1706 is working on another. 

As a rule, a 1706 would not be purchased to handle relatively slow peripherals (i. e. , the 
1742 line printer or 430 card reader/punch). These peripherals can very effectively be 
operated in interrupt mode as they will interrupt the CPU infrequently to perform their 
l/O. The 1706 would more effectively be used and needed to handle fast peripherals 
(such as magnetic tapes or the 405 card reader). For example, a 1732/608 magnetic 
tape can transfer one frame of data every 32 >is. Since MSOS can lock out interrupts 
for up to 50 ;us at one time, data could be lost on the tapes if they were not connected to 
a 1706. 

Software for controllers operated in the buffered mode through the 1706 should be con- 
sidered on an individual basis in the light of new software releases. 

10. 5 UNBUFFERED CONTROLLERS 

The standard controllers which could be operated in the unbuffered mode through the 
1705 to the A/Q channel are as follows. Most are shown in Figure 20. The newer ones 
are in Figure 21. 

• 1726/405 Card Reader -1200 cpm reader. 405 can also be connected through 1750 
via a 177 controller. Shown on Figure 21. 

o 1728/430 Card Reader/Punch - 500 cards per minute read; 100 cards per minute 
punch, (column punch) . Reader can be purchased separately as a 1729-2, 330-cpm. 
Punch can be purchased separately as a 420A, 100 cpm. 

• 1729-2 Card Reader - this is the replacement for the 1729 and it reads 330 cpm. 
Not shown on Figures. 

• 1731/601 Magnetic Tapes - this is the 1x8 controller for 601 magnetic tapes (200, 
556 bpi). They do not have assembly/disassembly mode. They have been updated 
by the newer 1732/608-609 tapes, and are now available only on a used basis. ^ 
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• 1732/608-609 Magnetic Tapes - the new controller, featuring assembly/ disassembly 
option, which replaces the 1731. One controller can handle up to eight tape units; 
608 ’s or 609 ’s or a combination of both. 

608’s - 7 track; bed or binary; 200, 556, 800 bpi; read forward and reverse 
609 ’s - 9 track; binary only; 800 bpi only; read forward and reverse 

Software from the 1731/601 is completely upward compatible with 1732 hardware. 

The 1732 is a more expensive controller than the 1731, but the added features 
would be desirable for the more sophisticated user: 

assembly/disassembly mode* 

800 bpi 

forward and reverse read 
9-track tape 

• 1735/915 Page Reader - optical character recognition equipment, 370 characters 
per second. Software operates as a compiler under Utility System; no standard 
driver is as yet available under MSOS, but it is planned to be added. 

• 1736-1 OCR Document Reader Controller - controls one 935-1 or 935-2 document 
reader. Software not yet available; will probably run under Utility first. 

• 1740/501-505 Line Printers - 501, 1000-lpm printer or 505, 500-lpm; 136 char- 
acters. Software not yet available for 505. 

• 1742 Line Printer (with controller included) - this is the Holley 300- 1pm with con- 
trol, 136 columns. 

• 1744 Digigraphics Controller - controls one 274 digigraphic light-pen console. 
Shown on Figure 21. Software is QSS. 

• 1745-1 Inquiry/Retrieval Controller - controls 211 Display/Entry and 218 Output 
stations. 

• 1746-1 Single Station Entry/Display - controls CRT display and keyboard. 

• 1747 Data Set Controller - controls 301- B data sets. Software runs under Utility 
System. Standard software is available for 6000 import/export. 

• 1749 Communications Terminal Controller - control s remote communications 
equipment, up to 16 lines per controller. Standard software is available only in 
the unbuffered mode on the 1749; software is not available to connect the 1749 
through the 1706 in a buffered mode. The 1748 is used for buffered operations. 

Standard software is available now or will be shortly on most of the peripherals above 
(except as noted) to run under MSOS in the unbuffered mode. 


*Also, new software for the 1732 utilizing assembly mode will mean the tapes only have 
to be accessed half as often. 
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10.6 160-A PERIPHERALS 

Several 160-A peripherals are connected to the 1700 on existing configurations through 
a 160-A adapter, and the 1750: 

a) 405 card reader (through 177 controller) 

b) 166 line printer and control 

c) 415 card punch (through 170 controller) 

d) 165-2 Calcomp plotter and control 

These equipments are not listed as standard available products as they are only available 
used on an as-available basis. 

10.7 1500 EQUIPMENT 

The 1500 series of analog equipment for process control is all connected to the 1700 
through different interfaces. A large, detailed chart of 1500 equipment is available 
through ADSD in La Jolla. Much of the series is shown in the Figure 20 chart and its 
primary interfaces are: 

a) 1750 DCB Terminator - this is the prime interface and it allows A/Q channel 
access to the 1500 series via the 1705. It is required if any 1500 equipment is to 
be connected to the computer. 

b) 1797 Buffered l/O Interface - this provides access to the DSA bus for buffered 1500 
equipment. It is functionally equivalent to the 1706 for standard peripherals. It 
is connected to the DSA and the 1750 and it controls up to three 157 1's. 

c) 1571 Chaining Buffer Channel - this is the priority buffer channel which assigns 
priorities to the equipment on the 1797. It is required if a 1797 is p r e s ent. A 
high priority piece of equipment can steal the channel away from a low priority 
equipment. 

See notes E-J of Figure 20. 

One piece of 1500 equipment will be mentioned here as it is nearly always needed in all 
configurations: 1573 Line Synchronized Timing Option. 

This is the clock connected to the 1750 which generates timed interrupts to the CPU 
(60/sec), Any process system which requires a clock for timed programs will need a 
1573 since there is no realtime clock in the computer itself. Many standard systems 
need a clock, especially to monitor l/O which can get hung up (for example, the 1706 
can hang up in a buffer operation if the peripheral malfunctions or drops Ready), Sev- 
eral controllers are capable of generating the necessary timed interrupt, but if one of 
these is not present in the system, the 1573 can be used. 

10. 8 PRIORITIES FOR DSA BUS 

Since all memory accesses, even buffered, must go through the Z register, priorities 
must be assigned to all the interfaces which may use the DSA bus. The 1797 takes 
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highest priority in direct memory access, the 1706 takes second priority, the standard 
buffered equipments (1738, 1751, 1748) take third priority. The running program takes 
lowest priority for accessing memory. On Figure 20, see ®, @, and (3). 


10.9 SUMMARY, CONFIGURING EQUIPMENT 

The chart in Figure 20 can be utilized very effectively to configure a system. Note that 
low- speed l/O package is connected to the CPU through the Low- Speed I/O Synchronizer. 
Each of the standard buffered equipments (1738, 1751 and 1748) has line connections 
leading to the CPU via the A/Q channel line and theDSA line. The unbuffered equipments 
connect to either the A/Q line or, through a 1706, to the DSA line and A/Q line (to add 
buffer capability). 

The 1750 connects to the 1705 (for A/Q access). The 1797 has lines to the 1750 and DSA, 
and the 1571 leads directly to the 1797. Note that all 1500 peripherals connect either to 
the 1571, 1797 or 1750. The 160- A peripherals connect through the 1750, 


10. 10 RELATED MANUALS 

Additional information on systems configuration will be found in: 
Systems Manual 

Communications Peripheral Equipment Manuals 
ADSD General Information Manual 
Pricing Manual 
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Figure 20. 1700 Computer System Block Diagram 
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Figure 20 (cent) 

Figure 20 is an overall view of a CONTROL DATA^ 1700 Computer System; it shows how 
different subsystems are used and the methods by which they can be connected. A few basic 
facts about the CDC®1700 Computer System are pointed out below. Each statement corres- 
ponds to letters on the block diagram. 

A Up to eight input/output (l/O) controllers can be connected directly to theA/Q channel and 
up to eight I/O controllers can be connected directly to the direct storage access (DSA) 
bus. However, this does not mean that 16 I/O controllers can be directly connected; 
only eight can be connected because each controller that is connected to the DSA bus must 
also be connected to the A/Q channel. 

B Only three CDC 1706 Buffered Data Channels and/or the buffered 1716 Coupling Data 
Channels can be used in a system complex; this is an addressing restriction, not a hard- 
ware restriction. 

C Each Model 1706 or 1716 provides up to eight data channels to which l/O subsystems can 
be connected. Either the 1706 or the 1716 permits the attached subsystems to operate 
via the direct storage access (DSA) bus. 

D The "OR" box indicates that the attached l/O subsystem can either operate through the 
1716 or connect directly to the A/Q channel. Operation via the 1706 is in the buffered 
mode; operation via the A/Q channel is in the unbuffered mode. 

E The CDC Model 1750 DCB Terminator is required whenever a CDC 1500 Series subsys- 
tem is used with the CONTROL DATA 1700 Computer. The 1750 provides a data and 
control bus (DCB) which is functionally equivalent to the A/Q channel. 

F The DCB provides the capability of attaching up to 15 CDC 1500 Series l/O subsystems, 
all of which operate through the A/Q channel via the Model 1750. 

G The CDC 1797 Buffered I/O Interface is required when the attached CDC 1500 Series sub- 
systems must operate through the DSA bus; it provides up to eight priority buffer chan- 
nels to which the CDC 1500 Series equipment can be connected. 

H The CDC 1571 Chaining Buffer Channel connects to one of the eight priority buffer chan- 
nels of the Model 1797. Up to three 1571*s can be connected to one 1797. Each 1571 
uses one priority buffer channel. 

NOTE 

If a 1797 is included in a system, the Model 1571 is also required 
to connect existing CDC 1500 Series l/O subsystems. 

I Each 1571 provides a buffered data and control bus (BDCB) to which up to 15 CDC 1500 
Series 1/ O subsystems can be connected. 

All devices that are shown connected to the BDCB can be connected to the DCB (refer to F, 
above); this means that the 1797/1571 is only required by system definition. 
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Figure 20 (cent) 

J Subsystems connected to the BDCB normally operate through the Model 1797 and the DSA 
bus. However, by program control, they can operate through the Model 1750 and the 
A/Q channel. 

K The 1587A Master Control Panel, 1587B Digiswitch Panel, 1587C Pushbutton Panel, 
1587E Rotary Switch Panel and 1587F Keyboard Panel connect to the 1564A through 
1564H Digital Input Signal Conditioning and operate through the 1544 Digital Input Inter- 
face with the 1545 Digital Input Sync Unit. 

L The 1587G Annunciator Panel receives its information directly from a 1553 External 
Register Output Interface. 
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Figure 21. 1700 Hardware Configuration 


1700 HARDWARE CONFIGURATION 



Standard software for the above 

four products Is availa^tr only when they 
arc attached to the 1':^$. 
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Figure 22 shows the latest configuration of communications equipment through the 
various communications controllers. 
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Figure 22. 1700 (1704 or 1774) Communications System Configuration 



•indicates COC terminal devices using compatible data sets may be used« 

Use of other than COC devices. must be coordinated with C$D Product Management. 
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The following is a systems bulletin describing buffered and non- buffered operations; 

buffered/non-buffered operations 

The purpose of this Data Sheet is to define the terms "Buffered and Non- Buffered" operations 
in terms of hardware. Hopefully, this will eliminate any misconceptions in actual hardware 
operations relative to the terms. It should be made clear that all l/O devices used with the 
1700 Computer are buffered in regard to the handling of data. Each output device or subsys- 
tem has a buffer into which the computer can load data. This is a temporary storage media 
that holds the data while the output device goes through its slow- speed operation using that 
data. During this time, the computer is free to continue on with its program. Each input de- 
vice or subsystem contains a buffer media into which it loads data until the running program 
can accept it as input and during which time the input device is obtaining the next set of data 
for entry into the buffer. 

Non- Buffered Operations 

The term "Non- Buffered" operation is synonomous with "Direct" operation, and means that an 
I/O operation is in progress and data is being transferred during the execution of an l/O in- 
struction via the computer’s A/Q Channel. Therefore, data is either being input to the A-Reg- 
ister or output from the A-register. The Q-register, in each case, holds an address speci- 
fying the equipment or device from which the data is coming or to which the data is going. 
Output data goes to a buffer for temporary storage until the device can use it and input data 
comes from a buffer where it has been waiting. This is the Non-Buffered or Direct I/O 
Operation. 

Buffered Operations 

The term "Buffered" operation means that the program has initiated an l/O operation for the 
Direct Storage Access (DSA) bus and is then free to continue its program while the actual data 
transfer is completed. The running program is not interrupted until the entire record has 
been either read or written. Typically, a buffered operation is carried out as follows: 

1) Normally initiated by the computer program executing a "Non-Buffered" input or output 
instruction to a device connected to both the A/Q channel and DSA bus. This Non-Buffered 
output would be the instruction telling the device or subsystem to start operating in the 
"Buffered" mode. 

2) Information supplied to the device during this Non-Buffered operation would be a "Pointer 
Word" that would point to a set of control words located in memory. 

3) These control words may represent the Starting and Ending memory addresses (Record 
length) plus any other information required by the device. They may also represent the 
starting and ending addresses used by the I/O device. 

4) Once the Non-Buffered operation is completed, the program is free to continue its 
function. 

5) When the specified device wants data or has data available, it requests a memory cycle. 
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6) On the next available memory cycle, the data word is transferred to or fetched from the 
memory. Therefore, the program is delayed for one memory cycle each time a data 
word is transferred in or out of memory. This is commonly referred to as cycle 
stealing. 

7) After each data transfer, the device or subsystem increments the current address and 
compares it with the Ending address. Steps 5, 6 and 7 are repeated until the current 
address and Ending address match (held in the 1571 or its equivalent). 

8) When the entire record has been transferred, the Buffered operation stops and the pro- 
gram can be interrupted. 

Direct Storage Access (DSA) 

Direct Storage Access is commonly referred to as Direct Memory Access or may just be 
called a memory channel. The 1700 Computer DSA contains a Data Register, Memory Ad- 
dress Register and control logic which enables attached devices or subsystems to request 
memory cycles and receive access to the memory on a priority basis. The DSA bus always 
have a higher priority than the arithmetic unit. With no Memory request from DSA, the 
arithmetic units requests will continue to be granted for consecutive memory cycles. How- 
ever, a Memory request from the DSA has first priority so that when received, the next mem- 
ory cycle is granted for DSA use. Once the DSA has control of the memory, it would use as 
many memory cycles as necessary to satisfy all requests from the devices on the DSA bus. 
For example, if six devices were attached to the DSA bus and all requested memory at the 
same time, the program would be effectively stalled for six memory cycles (6.6 ps) while 
these six requests were serviced. 

Summary 

hi summary, a Non- Buffered operation passes data in and out of the A-register via the A/Q 
channel while the Buffered operation passes data in and out of the memory on the Direct 
Storage Access Bus. 
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11.0 INTRODUCTION 

Advanced coding techniques for the 1700 will be the special considerations needed for 
understanding and writing programs that are part of the system. There are two sep- 
arate libraries of programs: the Program Library and the System Library. 

The programs in the Program Library are relocatable binary programs which are run 
in the background as jobs. This would include such programs as the library subroutines 
needed by the jobs. They are loaded into the unprotected background area of core by 
the loader, for execution, after being called in from the teletypewriter. Jobs could also 
be loaded from the card reader or paper tape reader for execution. 

The programs in the System Library are absolute programs which are part of the system; 
they are run in the foreground in a large area of protected core called allocatable core. 
This would include user process programs. The Operating System contains a directory 
of all the system programs (all the mass memory programs and maybe a few core 
resident programs). This is like a list of all the programs, by module name, and it 
contains the addresses of where they are. The system uses the directory to find the 
programs when it is desired to bring them into core to execute them. 



Protected core is normally synonymous with the foreground, and unprotected core with 
the background. In the background only one program (and its subroutines) would be in 
execution at one time at the lowest priority. In the foreground many programs could be 
in various states of execution at different priorities. The lower priority ones might have 
been suspended (temporarily stopped) while the highest priority one is executed. The 
unfinished programs wait in core to finish execution. If the system needs more allo- 
catable core because it is full, it will "swap out" the entire background area to the Swap 
area on mass memory, protect the background area, and use it for foreground programs. 
When enough foreground programs are completed in order to release the background 
area, that core is unprotected again and the job swapped back in to continue. 

Note that some of the system programs are core resident. The reason all of them are 
not core resident is that they will not all fit in core at once. Therefore, the ones which 
are not needed all the time reside on mass memory in the System Library and are 
called into allocatable core as they are needed. 

In order to understand what all these programs look like and how they execute, as well 
as how they call each other in to core, it will be necessary to study the different kinds 
of programs. 

Emphasis in this chapter will be on system programs as background programs will run 
with any of the coding techniques previously covered. 
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Figure 23, Mass Memory and Core Maps 
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An introduction to the priority structure of the running programs under MSOS will also 
be helpful as an introduction to this chapter. There are 16 program priorities from 15 
(high) to 0 (low). An idle loop runs at priority -1 when the system has nothing else to 
do. These priorities pertain to core resident and mass memory resident programs. 
When a program is running at its priority, it can be suspended by any higher priority 
program which the system allows to run. The suspended program waits in core to re- 
sume execution when the priority structure works back down to it. 

The priority structure can only be changed by interrupts (hardware) or scheduling (soft- 
ware). The mask in the M register allows hardware, which has a higher priority than 
the running program, to interrupt. When an interrupt occurs, the Common Interrupt 
Handler saves all the registers of the interrupted program on the Interrupt Stack (so 
that the program can later be resumed) and transfers control to the program which will 
service the interrupt on the line. 

A schedule request allows a program to change the priority level. If the request is for 
a higher level program, a pseudo interrupt will occur immediately (the suspended pro- 
gram goes on the Interrupt Stack) and the higher level program is executed. Control 
will later return to the suspended program. If the schedule request is for an equal or 
lower level priority, the request parameters go on the Scheduler Stack and are threaded 
in it by priority to be picked up later when the priority structure works down to that level. 

All programs exit to the MSOS Dispatcher, It is the Dispatcher that must cause the next 
lowest priority program to be executed. It does this by looking at the Interrupt Stack 
and Scheduler Stack and finding the highest priority waiting program. 



Scheduled 
Programs 

Hardware 


Interrupts 

from 
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11.1 SOURCE, OBJECT AND ABSOLUTIZED PROGRAMS 



11. 1. 1 Source Program 

The source program is the program written in assembly language code by the 
programmer. It most likely would be punched on cards or on paper tape. Here 
is an example of a source program listing: 


0001 





NAM 

SOURCE 

0002 





ENT 

START 

0003 

poooo 

0000 


START 

0 

0 

0004 

POOOl 

C400 



LDA^ 

X 


P0002 

0006 

P 




0005 

P0003 

60FF 



STA- 

I 

0006 

P0004 

1400 



JMP^ 

(START) 


P0005 

8000 

P 




0007 

P0006 

0010 


X 

NUM 

$10 

0006 





END 

START 


I OOFF START OOOOP X 


0006P 

C 


The source program is read into the computer by the assembler. The computer 
does not execute the program at this time. The assembler translates the 
mnemonics into binary object code. The source program is listed at this time 
(on the teletypewriter or the line printer) and the object program is punched on 
paper tape (or on the disk, drum or magnetic tape) . 


11. 1. 2 Object Program 

It is important to know that the object program is not executed either. It must be 
loaded by a "relocating" loader back into the computer before it can be executed. 
It is not important at this point to be able to interpret the codes in the object pro- 
gram. One must just understand that the codes represent the desired program 
and that the loader will interpret the codes when it loads the object program and 
will make an executable program out of these codes. On the following page is an 
example of how the previous source program would look in object form. 
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Figure 24. Object Tape 



Note that each block on the paper tape is preceded by the one’s complement of the 
word count in that block and followed by a checksum word on that block. 
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Figure 24. Object Tape (Cent) 



NAM BLOCK 


0010 

0000 

0101 

0000 

0 

0 

0 

0 

0 

0 

0 

0 



0 

7 

s 

o 

u 

R 

c 

E 


RED BLOCK 


0100 

0000 

0101 

0000 

0001 

0000 

0000 

0001 

0 

0 

0 

0 

0 

0 

0 

0 

c 

4 

0 

0 

0 

0 

0 

6 

0000 

0000 

0001 

1000 

6 


F 

F 

1 

4 

0 

0 

8 

0 

0 

0 



1 

0 

0 

0 

0 

0 


1 word = 2 frames on paper tape 



ENT BLOCK 


1000 0000 

0101 0000 

s 

T 

A 

R 

T 


0 0 0 0 


XFR BLOCK 


1100 0000 

0101 

s 

T 

A 

R 

T 
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The following is some of the information about the blocks the assembler makes in 
the binary object program for the loader. This was extracted from the Loader 
Chapter of the MSOS Reference Manual, and it may be consulted for more detail. 

Relocatable Binary Input 

The loader recognizes relocatable binary blocks by the type indicator field in 


bits 13-15 of the 

first word of the block. 

The following block types are defined: 

Type 

Indicator 

Description 

NAM 

001 

Name block 

RBD 

010 

Command sequence block 

BZS 

Oil 

Zero storage block 

ENT 

100 

Entry point block 

EXT 

101 

External name block 

XFR 

110 

Transfer address block 


If the loader is unable to recognize the indicator, it does not process the block. 
NAM Block 

The NAM block contains a word count for common storage and data storage, the 
program length, and the name of the program. 


[ Program 
Name 


0010 

0000 

0101 

0000 

Number of words in common storage block 

Number of words in data storage block 

program length 

character 1 

character 2 

character 3 

eharacter 4 

character 5 

character 6 


RBD Block 

An RBD block contains a portion of the actual command sequence data of the pro- 
gram. Words 2-59 contain the relocation bytes and words for the command 
sequence input. Each relocation byte is a 4-bit indicator that identifies a word 
of the command sequence input as an absolute 15-bit address or as a 15-bit address 
relative to some relocation base. The relocation base for a word is determined 
by the particular combination of bit settings within the relocation byte. 

Relocation bytes in RBD blocks : 

0000 Absolute (no relocation) 

0001 Positive program relocation 

0101 Negative program relocation 

0010 Positive common storage relocation 

0110 Negative common storage relocation 

0011 Positive data storage relocation 

0111 Negative data storage relocation 
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Wn nth word of input block, (n=l-45) 

Rn Relocation byte of nth word 
WO Origin address of input block 

RO Relocation byte for WO 

There is one relocation byte for every word in the command sequence input, and 
a maximum of 45 words in an RED block. The first word is the address at which 
the loader begins storing command sequence data. The relocation byte for the 
first word address (storage address) of an RED block may be 0000, 0001, or 0011. 
Zero is the leading bit for all but the last relocation byte; one is the leading bit for 
the last relocation byte. 

In processing an RED block, the loader picks up the 15 bits which represent the 
first word address of the command sequence data in the block. It adjusts this 
address for relocation according to the setting of the bits representing its relo- 
cation byte. The resulting absolute address is the first word address in core to 
receive the command sequence data (stored in consecutive locations). Each word 
is relocated according to its relocation byte. 
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ENT Block 


1000 0000 

0101 0000 

name 1 character 1 

character 2 

3 

A 

5 

6 ' 

El 

name 2 






E2 

^ 


name 13 






e: 

L3 

name 14 






E14 

not used 

not used 


Core Image of ENT Block 

Namen = Six- character name of nth entry in block 
En = Entry point address of nth name 

XFR Block 

The XFR block contains a transfer address (in words 2-4), which is six ASCII 
characters in length, including trailing spaces. The transfer address must be an 
entry point in the program being loaded or in another program loaded during the 
same load operation. 


1100 0000 

0101 0000 

Character 1 

Character 2 

3 

4 

5 

6 


Core Image of XFR Block 

The XFR block must be the last in a relocatable binary program. If an XFR block 
is out of order, a loader error message is issued and the load is terminated. The 
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loader records the transfer address in theXFR block. If two or more relocatable 
binary programs are loaded with one operation, the loader saves the last trans- 
fer address for the start of execution. 

It is obvious by looking at the code that it could not be executed exactly as it ap- 
pears. Normally the programmer never has to know what the object tape looks 
like. He would only have to know the format if he wanted to examine parts of the 
tape. For example, if he stored a number of object programs on one tape, he may 
wish to be able to search the tape for a particular program. He could do that by 
writing a program to look at the NAM blocks until it found the right one. 

11. 1. 3 Absolutized Program 

The programmer is, however, very much concerned with how the program looks 
after it is loaded into core for execution. The different addressing modes he used 
when he wrote the source program will determine what the final core image of 
that program looks like. An absolutized program is an exact copy of this core 
image, which can be executed. The loader loads and absolutizes the object pro- 
gram at a certain address, which is wherever it happens to load it. It also links 
the program to any externals and loads and links any library subroutines required. 
A utility routine could be used to punch a tape with this core image on it; hence, 
the term "absolute tape". Here is an example of an absolutized image of the pre- 
vious object program, (if the program was loaded at $1000). 


($1000) 

0000 

0 

0 

($1001) 

C400 

LDA+ 

X 

($1002) 

1006 



($1003) 

60FF 

STA- 

I 

($1004) 

1400 

JMP+ 

(START) 

($1005) 

9000 



($1006) 

0010 

NUM 

$10 





Notice that the contents of location $1002 is $1006 to indicate where X is and that 
$1005 contains $9000 to indicate the jump through location $1000. The 0006P and 
8000P in the source code were relocated by the loader when the object pro- 
gram was loaded. No matter where the program was loaded, the correct addresses 
would be filled in at that time. 
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Figure 25. Flow of Program Through Execution 



unprotected core 
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11. 1.4 Form of Programs in MSOS Libraries 

The reason it is so important for the analyst to understand the distinction between 
what the object program generated by the assembler and the absolutized program 
after loading look like is because user and system programs are stored in the 
libraries on mass storage in these two different forms. User background pro- 
grams in the program library are stored in relocatable binary object form. They 
will be loaded by the loader into core whenever they are executed, so they will be 
absolutized and linked each time they are loaded and run. 

System programs (including user process programs) in the system library are 
stored in absolutized form and will be read into core (without any changes) when- 
ever they are needed for execution. This is because it must be possible to bring 
the real time process programs into memory very fast; the relative time it would 
take to load them in with the loader every time they are needed would be too great. 
A much better solution would be to write the source program in such a fashion that 
the absolutized program could be run anywhere in core and would still execute 
properly. The absolutizing of the system process programs is done during system 
initialization (by the loader portion of the system initializer) when the programs 
are stored on the system library. 

11.2 RUN AITTOHERE CODING 

11. 2. 1 Writing Programs for Run Anywhere Coding 

The method devised for writing programs so they can be stored in absolute form 
and still run anywhere in core is called Run Anywhere Coding. It is important to 
know that this is done at the source level. 

Source Object Absolute 



Runanywhere or Runanywhere or Runanywhere or 

not Runanywhere not Runanywhere not Runanywhere 

The object program can be loaded anywhere and absolutized and will run correctly 
at that time because the loader has relocated any addresses which were in the 
program. However, if an absolute image of this program is later run somewhere 
else in core, it will run correctly if it was coded run an3rwhere in the original 
source form. Here is an example of the same program coded both ways; (assume 
it was loaded and absolutized at $1000). 
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Source 


Not Runany where 

Absolute 


START 

0 

0 

($1000) = 0 0 0 


LDA+ 

X 

($1001) = C 4 0 




($1002) = 1 0 0 


STA- 

1 

($1003) = 6 0 F 


JMP+ 

(START) 

($1004) = 1 4 0 




($1005) = 9 0 0 

X 

NUM 

$10 

($1006) = 0 0 1 


Runanywhere 


Source 



Absolute 


START 

0 

0 

($1000) = 0 0 0 

0 


LDA* 

X 

($1001) = C 8 0 

3 


STA- 

I 

($1002) = 6 0 F 

F 


JMP* 

(START) 

($1003) = 1 C F 

C 

X 

NUM 

$10 

($1004) = 0 0 1 

0 


Notice that the addresses of X and START in the first example were relocated by 
the loader to show that X is at $1006 and START at $1000. The program will run 
at $1000, but if, for example, it is moved to $2000 without the object being reloaded, 
it will not run correctly because it will think Xis at $1006 (when actually it moved 
to $2006) and then it will jump through $1000 (when actually the entry point START 
moved to $2000). 

However, in the second example all addressing in the program is relative. The 
LDA* loads from X which is 3 locations forward and the JMP* jumps through 
START which is 3 locations backward. Yet the STA- I must be left as it was 
because the I register is absolute core location $FF, and it will always be there. 
The program is runanywhere because it can be kept in absolute form and can be 
later run anywhere in core with correct results. 

One might at this point wonder why not code all programs in run anywhere form. 
The primary reason is that it is more difficult to learn to do run anywhere coding 
since there are more chances for the programmer to make errors which will not 
produce any error messages. In general, when writing a program to be run 
anywhere, all references to addresses that move with the program should be 
relative, and all addresses which are absolute core locations must be absolute. 


o 
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references to subroutine 
of program relative 


references within 
program relative 



COMMON 


t 

t. 


SUBROUTINE 


PROGRAM 


CORE RESIDENT 
PART OF 
SYSTEM 


references to common 
absolute 


references to low core 
absolute 


SCAN 


NAM 

RA 

ENT 

SCAN 

EXT* 

ALARM 

EXT 

LOWPGM 

COM 

X(10) 

0 

0 

1 


LDA+ 

r 

X+0 

1 

STA- 

s 

$FF 

1 

LDA+ 

V 

$10C 

I 

RTJ 

V 

ALARM 

i 

RTJ+ 

LOWPGM 

1 

END 



relative external 
absolute external 


reference common abso- 
lute 

reference $FF absolute 

reference interrupt trap 
absolute 

reference subroutine 
relative 

reference program- in 
system resident absolute 


Without worrying about the externals at this point, note that all references within 
the program area must be relative. A good way to tell if there are any which are 
not relative is to look at the source listing and see if any of the codes on the left 
are followed by a P, i. e. , in the program SOURCE example, change: 


POOOl 

C400 

LDA+ 

X 

P0002 

0006P 

<> \ 
\ 1 


POOOl 

C803 

LDA*^ 

X 


i '' 
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Change all loads, stores, jumps, etc. , in the program to relative. 

Look at the VALUE problem from chapter 6 and observe the addressing used in 
the program. COUNT is addressed in two-word relative mode, because the DATA 
block most likely moves with the program and may be further away than 127 ]^0 
locations. LPMASK+6 is addressed with one-word absolute mode because it is a 
fixed low core address. MASK in the program is addressed in one- word relative 
mode because it moves with the program. Yet X in the common block must be 
addressed in two- word absolute mode because common is fixed and is in high core. 
The LDA VALUE is in two-word relative mode. This implies VALUE is relative 
to the TEST subroutine and the assembler requires two-word addressing for any 
relative externals. 
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VALUE PROBLEM 



NAM 

TEST 


COM 

DUMMY(10),X(10) 


DAT 

DUM(6),COUNT(l) 


EQU 

LPMASK($2) 


ENT 

START 


EXT* 

VALUE 

MASK 

BZS 

MASK(l) 

START 

0 

0 


CLR 

Q 


STQ 

COUNT 


LDA 

VALUE 


AND- 

LPMASK+6 


ALS 

8 


STA* 

MASK 


ENQ 

9 

SEARCH 

LDA+ 

X,Q 


AND 

=N$3F00 


EOR* 

MASK 


SAN 

i 


RAO 

COUNT 


SQZ 

EXIT-*-l 


INQ 

-1 


JMP* 

SEARCH 

EXIT 

JMP* 

END 

(START) 
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11. 2. 2 Buffer Addresses 

Buffer addresses used for indirect addressing (to load or store) in the program 
must be absolutized each time they are used. If the buffer is in low core system 

resident, it can be absolutely addressed: 

I 

I 



EXT 

BUF 

BUFADR 

ADC 

1 

1 

BUF 


1 

1 

STA* 

(BUFADR) 


I 

1 


The address assembled into BUFADR will be the absolute address of the buffer. 
Since the buffer will never move, even though the program moves, the addressing 
will still be correct. 

However, if the buffer moves with the program, the ADC would not work because 
it would contain the address of where the buffer was when the program was abso- 
lutized. In the following example RELATIVE the buffer BUF is in the program at 
P0007. BUFABS must always contain the address of where the buffer really is. 
If we used: 

BUFABS ADC BUF 

BUFABS would assemble as 0007P which, if the program was absolutized at $1000, 
would contain $1007. Whenever the program moved, the buffer would not be at 
$1007 any more. Neither would the example at P006C work correctly for the same 
reason. 

Study the code beginning at POOOO and see that BUFABS is calculated each time it 
is used. The RTJ* will cause the current address of the BD instruction to be 
stored in BD. (RTJ stores P+1 in jump address, then RNI at P+2.) Then the 
LDA calculates the distance from BUF to BD. ADD the contents of BD (the current 
address of BD) and store it in BUFABS to calculate the buffer address! 



11.2.2 


CORRECT 


INCORRECT 


, 0001 NAM RELATIVE 


n ■"" 0002 ”"' ' 

\ 0003 POOOO 5801 RTJ* *+l 

ooo4"pbooi 0000 Bb ' NUM 0 

P, 0005 P0002 COOO LDA =XBUF-BD 

P0003“'0006 

„ 0006 POOOA 88FC ADD* BD 

‘ — 0007 ‘P00d5 6866 STA* BUFABS 

, 0008 * 

0009 " 

Q, p 0010 P0006 0000 ^ _ __ SLS 

■"'001 rPOOOT 0064 BUF 'BZS"" "" "BUFCIOO) 

„ 0012 P006B 0001 _ BUFABS_ BSS _ BUFABS(l) 
C' '""0015”" * 


0015" P00”6C GOOD "LDA zXBUf 

P006D 0007 P _ _ __ _ _ 

dor6”^Pbb6X68^^ "" STA* BUFABS' 

0017 END 



The buffer address will be correct whether the buffer is forward from the LDA 
=XBUF-BD or behind it, because of the 15-bit arithmetic used. With BUF in its 
current location the calculation would be 

0007 

-0001 

0006 assembled 
+0001 

0007 

If the buffer were at 7FFE relatively, the calculation would be 

7FFE 
-00 01 

7FFD assembled 
+00 01 
7FFE 

A very nice way to clean up even the correct code above would be: 

RTJ* BUFABS 

BUF BZS BUF(IOO) 

BUFABS 0 0 

I 
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The RTJ jumps over the buffer, taking the buffer address with it. It stores it in 
BUFABS, then continues execution following BUFABS. 

Look at the peripheral program BOOTSTRAP for the paper tape reader in chapter 
8. Location P0012 is used to contain the buffer address of where the data is to 
read into. Since this address is program relocatable (contains 0014P), the pro- 
gram is not run anywhere because when it is loaded and absolutized P0012 will 
contain the absolute buffer address at that time. If the program and buffer were 
moved, ADDRES would then contain the wrong buffer address. 

More coverage of the externals for run anywhere programs will be mentioned in 
a later section, 11.6. How the externals are written depends primarily on where 
they and the referencing program are in the system. 


11. 2.3 X Bit in System Requests 


In run anywhere programs, the X bit must be used in system requests; and ad- 
dresses used in the requests must follow the same rules for addresses in the 
program which move relative to the program or are external in low core. 

The following example is for the X bit being set in a schedule request: 

RTJ- ($F4) 

VFD N7/9, Nl/1, N8/8 

ADC* HELP+1 


/ 


9 

T 

0 

8 

d 

istance 


Since this is a request made from a run anywhere program, the address being 
scheduled, which is HELP, must be relative if HELP is relative to this request. 
(HELP could be in the scheduling program or external to it.) 


When the X bit is used as above to indicate relative addresses, the relative dis- 


tance must be from the first word of the parameter string (not from the RTJ or 
the ADC). That is why the relative address constant (ADC* HELP+1) is coded as 
HELP+1 instead of HELP. The distance established from the ADC to HELP+1 
would be the same distance as from the VFD to HELP, which is the distance 
required by the operating system. 


POOOO 

POOOl 

P0002 

P0003 

P0004 

P0005 

P0006 

P0007 

P0008 

P0009 


7 


7 


54F4 

1308 

0007 


HELP 


RTJ- 

VFD 

ADC* 


($F4) 

N7/9, Nl/1, N8/8 
HELP+1 


11-ltJ 




11.2.3 


Of course, if HELP were a core resident program, it would have to be scheduled 
absolutely from a run anywhere program. It can be scheduled this way e/en if it 
is in the system directory. 


54F4 

RTJ- 

($F4) 

1208 

NUM 

$1208 

7FFFX 

ADC 

? 

HELP 


1 

EXT 

HELP 


When the X bit is set to indicate relative, addresses in that request must fol- 
low suit. In an I/O request, for example, the completion address and buffer 
address must be relative. Again, they must be relative to the first word of the 
parameter string. 

F WRITE, RP=5, CP=6 
ASCII, STD PRINT DEV 


Note that COMPL+1 is used to add 1 to the distance between the ADC* and COMPL 
(to make it relative to REQ). BUF+5 is used to add 5 to the distance between the 
ADC* and BUF. The number of words does not have to be relative even though 
the X bit is set. 

If it is desired to use relative addressing to locate the number of words, it would 
be done as follows: 

REQ 


COMPL 

BUF 


RTJ- 

($F4) 

NUM 

$0D56 

ADC* 

COMPL+1 

NUM 

0 

NUM 

$18FC 

ADC* 

(N+4) 

ADC* 

BUF+5 


1 



RTJ- 

($F4) 

REQ 

NUM 

$0D56 


ADC* 

COMPL+1 


NUM 

0 


NUM 

$18FC 


NUM 

10 


ADC* 

S' 

BUF+5 

1 

COMPL 

f* 

BUF 




N NUM 10 
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All other requests which can utilize the X bit for relative addressing must follow 
the same pattern. 

The ADC* in the above examples will only calculate the correct distance for ad- 
dresses forwa^ from the ADC*. Since the relative address must be a 15-bit 
positive increment which is added to P and must work whether the distance is for- 
ward or backward, the following method is often used: 


ADC COMPL-*+l 

or 

ADC BUF-*+5 

The regular ADC form used here has an expression in the address field which will 
always calculate the correct distance. The desired address minus the current P 
counter makes a 15-bit relative distance from P and the adjustment of +1 or +5 in 
the example is for a completion or buffer address. 

Figure 26 shows incorrect examples of relative addressing. See MMPGM in the 
mass memory coding section 11.5.7 for more examples. Relative addressing is 
detailed in Chapter 8 of this manual. Also, the MSOS Reference Manual contains 
details of using the X bit in all system requests. 
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Figure 26. Error Examples for Incorrect Addressing in 
Mass Memory Programs 


0013 



0013 

P0002 

54F4 

0013 

P0003 

0D56 ^ 

0013 

P0004 

0012 P ■ 


P0005 

0000 

0013 

P0006 

18FC 

0013 

P0007 

OOOA 


P0008 

0018 P 

0013 


' 

0013 

P0002 

54F4 

0013 

P0003 

0D56 

0013 

P0004 

OOOF 


P0005 

0000 

0013 

P0006 

18FC 

0013 

P0007 

OOOA 


P0008 

8018 P - 


Buffer is at P0018 

! NOTE: QQjnpXetion address is at P0012 
FWRITE $FC, WROTE, MSGBUF, 10, A, 5, 6, 1, 1 

X bit set 


But address still program relocatable 
Buffer was at P0018 in early example 
FWRITE $FC, WROTE-*+l, (MSGBUF), 10, A, 5, 6, 1, X 
X bit set 

Rel. dist. to WROTE 


Indirect bit on buffer address 



NOTE- P0003 

Completion address is at POOID 


0016 



WRITE 

0016 

POOOD 

54F4 


0016 

POOOE 

0D56 


0016 

POOOF 

7FEC 




POOlO 

0000 


0016 

POOH 

18FC 


0016 

P0012 

OOOA 


5f: H< ** JX L ******** * 


P0013 

0000 

^ 

0016 



WRITE 

0016 

POOOD 

54F4 


0016 

POOOE 

0D56 


0016 

POOOF 

7FEC 




POOlO 

0000 


0016 

POOH 

18FC 


0016 

POOH 

OOOA 



POOH 

OOOB 




FWRITE $FC, *-WROTE-5, *+MSGBUF-5, 10, A, 5, 6, 1, X 


Wrong rel. dist. to compl. 


Illegal relocation to buffer 

FWRITE $FC, *-WROTE-5, *-MSGBUF-5, 10, A, 5, 6, 1, X 


Wrong rel. dist. to compl. (appears backward) 


Backward rel. dist. to buffer (appears forward) 
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Problem; Write a runanywhere program. 

Given: skeleton of a program which computes an average of 10 positive numbers. 



NAM 

AVERAGE 


ENT 

AVG 


BZS 

OVFL(l) 

AVG 

0 

0 


ENQ 

9 


ENA 

0 


sov 

0 

LOOP 

ADD* 

X,Q 


SNO 

TEST-*-l 


RAO* 

OVFL 


AND 

=N$7FFF 

TEST 

SQZ 

AV-*-l 


INQ 

-1 


JMP* 

LOOP 

AV 

LDQ* 

OVFL 


ALS 

1 


LRS 

1 


DVI 

=N10 


JMP* 

(AVG) 


END 

AVG 
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a. Write a main program, with a buffer with data in it, to call AVG as a sub- 
routine. Set up the proper linkage between the main program and its sub- 
routine. The main program should punch the answer (the average of the data) 
on binary paper tape. * Be sure the programs work before going further. 

b. The programs should be coded in runanywhere form and should not destroy 
themselves. 

c. To checkout the runanywhere features of the programs add a move subroutine 
to move the main program and AVG to a higher core area after they have run 
once and given one answer. Then control should be transferred to the entry 
point of the main program at its new address to run it again and see if it 
gives the same answer. 

This will simulate a runanywhere mass memory module being executed in a 
different core area, and it can be checked out in the background with the 
protect switch set. 

IfCONVRTis used, it should not be moved in the move and should be addressed 
absolutely. This is because it is not runanywhere. Using CONVRT would 
simulate a mass memory module calling a core resident subroutine which 
remains at a fixed location even though the module runs indifferent locations. 

11. 3 REENTRANT CODING 

It is necessary in a real time process environment for many of the programs to be 
reentrant. This is because the process programs run at different priority levels and 
may have common subroutines. A reentrant program is one that can be entered at more 
than one priority level. The program may begin its computations but be stopped (per- 
haps as a result of a hardware interrupt at a higher level). Then it may be entered 
again at a higher level (perhaps by being called by the higher level interrupting pro- 
gram). It must do a computation for the higher level calling program. Then it must 
resume the original computation later without losing any continuity or results. An 
example of a situation in which a subroutine PGM must be reentrant is as shown on the 
following page. 


*The main program could instead call the CONVRT conversion subroutine to convert the 
hexadecimal answer to ASCII codes, then write it in ASCII on the teletype. 
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11.3 


(Priority 4) 
Program A 

© 



(Priority 6) 
Program B 


RTJ+ PGM 



Exit 


RTJ+ 



Exit 


I PGM / 

©I j © I 

hardware ( I 

interrupt ^ 

I 

1. Program A runs at Priority 4 and 

2. calls PGM (at same priority). 

3. PGM is running when 

4. an interrupt occurs. 




PGM 

© 




5. Program B begins to run at priority 6 (higher) as a result of the interrupt, and 

6. it, too, calls PGM. 

7. PGM must run a calculation for program B and 

8. return to program B. 

9. Program B must complete and exit. At that time 

10. the priority drops back down to 4, and PGM resumes its computation for program 
A where the interrupt occurred. It must correctly complete its run for A and 


11. return to program A. A then can 

12. complete and exit. PGM must be reentrant so it can make correct computations 
and exits for A and B. 
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11. 3. 1 Methods of Reentrants 

There are a number of different methods which are used to make programs 
reentrant. 1700 MSOS provides for reentrant programs by containing a core 
area called Volatile Storage which any protected program may use. Volatile 
storage is actually a BSS block in the program VOLA and its size is set up at 
system initialization time. A program can establish its reentrancy by requesting 
a temporary area of volatile storage for each run in which to store its temporary 
results during execution. No locations in the program area can be used for 
temporary results because they would be destroyed if the program was reentered 
before it completed execution. Therefore, all data would be either in volatile 
storage or in the registers. (P,A,Q and I would be saved in the interrupt stack if 
an interrupt occurred. ) 

The following program can be used as an example and it will be recoded to be 
reentrant. The addresses of two parameters which are to be added together by 
the subroutine are passed in A and Q. The answer is to be passed back in A. 





NAM 

ADD2 


ENT 

ADD2 


ADD2 0 

0 


STA* 

TEMP 

STORE ADDRESSES OF 

STQ* 

TEMP+1 

PARAMETERS. 

LDA* 

(TEMP) 

PICK UP PARAM 1 

ADD* 

(TEMP+1) 

ADD PARAM 2 

JMP* 

(ADD2) 

RETURN WITH ANSWER 

f 


IN A 

BSS 

TEMP(2) 


END 




The program as it is written above would not be reentrant because its return ad- 
dress and parameter addresses would be lost if the program was reentered before 
it was finished. 



11. 3.1 




The following is the program coded in reentrant form. 




NAM 

ADD2 




ENT 

ADD2 




EQU 

AVOLA($BB), AVOLR($BA), ZERO($22) 

1. 

ADD2 

0 

0 

ENTRY POINT 

2. 


IIN ■ 


LOCK OUT INTERRUPTS 

3. 


RTJ- 

(AVOLA) 

GO GET SOME VOLATILE 

4. 


NUM 

4 

4 WORDS WANTED 

5. 


EIN 



6. 


LDA* 

ADD2 

PICK UP RETURN ADDRESS 

7. 


STA- 

3,1 

SAVE IT IN VOLATILE 

8. 


LDA- 

(ZERO),Q 

GETPARAM2INA ^ 

9. 


LDQ- 

1,1 

GET PARAM 1 ADDRESS IN Q 

10. 


ADD- 

(ZERO),Q 

ADD PARAM 1 TO PARAM 2 

11. 


STA- 

1,1 

PASSANS. BACK IN A 

12. 

EXIT 

LDQ- 

3,1 

PICK UP RETURN ADDRESS 

13. 


IIN 



14. 


STQ* 

ADD2 

STORE RETURN ADDRESS 

15. 


RTJ- 

(AVOLR) 

GIVE BACK VOLATILE 

16. 


EIN 


ENABLE INTERRUPTS 

17. 


JMP* 

(ADD2) 

EXIT 



END 










4-word volatile storage block 


Q 




3 I Return 
2 
1 

(I) + 0 

/ 

Subroutine ADD2's I register contains volatile address. 


S calling program's registers 


J 


A separate 4-word block of volatile storage will be assigned each time the program 
is reentered. Since its I register is always saved when an interrupt occurs, the 
value of I in each run will locate the specific block being used in that run. 

Successive blocks allocated will always be to higher priorities and, naturally, 
release will be in reverse order. 
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ENTRY 




11.3.1 


$1008 


$1004 


$1000 


Lines 1 through 7 in the example ADD2 program could be the same in any re- 
entrant program consisting of getting volatile storagd for that run and saving the 
return address. Lines 12 through 17 could be the same also, consisting of 
returning the volatile and exiting. Lines 8 through 11 comprise the program 
itself. Note that in this case no TEMP's were needed because the parameter 
addresses in the calling program’s A and Q registers are contained in volatile 
locations 1 and 0 and they can be used to access the parameters. The following 
is a line-by-line description of the reentrant coding for the ADD2 program. 

1. The entry point is entered by a RTJ from the calling program. 

2. The subroutine must lock out interrupts because the return address which the 
RTJ stored in the entry point must not be lost. Since the RTJ instruction 
stores its return address in the jump address and does an RNl at jump ad- 
dress+1 (line 2, the IlN) an interrupt cannot occur and wipe out the return 
address in ADD2 before the IIN. The IIN must also be in effect before the 
RTJ to VOLA because VOLA is not reentrant and expects interrupts to be 
locked out before it is entered. 

3,4 Jump to VOLA (through locore location $BB). Pass a parameter to VOLA 
requesting four words of volatile storage. A different block will be assigned 
each time this subroutine is entered, and the address of the block comes to 
the calling program (ADD2) in 1. ADD2 must never destroy its 1 register 
because it contains the address of the volatile block. VOLA also saves the 
calling program’s Q, A and I registers in the first three words of the block. 

All the registers inADD2 (including I) will always be safe from an interrupting 
and reentering program because ADD2’s registers would be saved on the 
interrupt stack. 


Return 
I 

A 

Q 


Volatile assigned on 3rd entry; 
i. e. , at priorityG, I register 
contains $1008 


Return 
1 

A 

Q 


Volatile assigned on 2nd entry; 
i. e. , at priority 5, I register 
contains $1004 


Return 
I 

A 

Q 


Volatile assigned on 1st entry; 
i. e. , at priority 4, I register 
contains $1000 
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5. Enable interrupts as soon as possible because it is illegal to lock them out 
for more than 50 jjls (including the time in VOLA). 

6. One free instruction is allowed after theEIN before an interrupt can occur; so 
the return address is rescued from the entry point — it will be safe in A. At 
any time after this point an interrupt can occur and the Interrupt Handler 
will save the registers. 

7. Store the return address in volatile so that the A register can be used in the 
program. 

8. Q still has the address of parameter 2 in it from the calling program so it can 
be used to get the parameter into A. 

9. The address of parameter 1 was passed in A and VOLA put it in the 2nd word. 
It can be loaded into Q. 

10. Parameter 1 is then added into A using the address in Q. Note in 8 and 10 
that the addresses are put in Q. One way of addressing the parameters which 
would not work is ; 

LDA- (I+l) 

ADD- (I+O) 

It looks like it would work because the addresses are in I+l and I+O but this 
would be assembled as $100 and $FF which of course is not where the ad- 
dresses are. An assembly error would probably occur at the I+l. Another 
method which would not work is: 

LDA- ($3), I 

ADD- ($22), I 

Location $3 has a 1 in it to which will be added the contents of $FF (giving I+l) 
and the add would be from 0+ the contents of $FF (giving I+O). This would 
get the parameter address in A. Then the ADD would add in the second 
parameter address. 

11. The answer is stored in volatile+l because that is where VOLR will restore 
the A register from. Any parameters to be returned in registers must be put 
in the first three words of volatile. 

12. The return address must be picked up out of volatile because volatile is going 
to be returned and it would be lost. 

13. Interrupts are locked out for exiting. 

14. The return address is stored in ADD2 because the original Q is going to 
replace ADD2’s Q. 
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15. Volatile is returned. VOLR restores the original registers from the first 
three words of volatile ! That is why the answer was put there, to get it in 
the original A. Also, since volatile is now gone, the return address had to 
be rescued; and it could not be left in Q (to exit through Q) because ADD2’s 
Q is gone. 


16. 

Enable interrupts. 



17. 

Free instruction to exit. 




Incorrect example: 




line 10 ADD- 

(ZERO),Q 

ANSWER IN A. 


LDO- 

3,1 

RETURN ADDR IN Q 


RTJ- 

(AVOLR) 

RETURN VOLATILE 


EIN 




I ► JMP* 

(ZERO),Q 



Q now has the original Q in it, not the return address; also the answer in A 
was clobbered and has the original A in it. 

If any other temporary locations were needed by the reentrant program, they 
would be requested in volatile and would be addressed the same way. For ex- 
ample, if it was desired to move the parameter addresses to volatile +5 and 6 
(like TEMP'S in non-reentrant program), the NUM in line 4 would be 6 and lines 
8 through 12 would be replaced with: 


LDA- 

1,1 

PICK UP PARAM 1 ADDRESS 

STA- 

4,1 

MOVE TO TEMP (1+4) 

LDQ+ 

0,1 

PICK UP PARAM 2 ADDRESS 

STQ- 

5,1 

MOVE TO TEMP+l(I+5) 

LDQ- 

4,1 

GET PARAM 1 ADDRESS IN Q 

LDA- 

(ZERO),Q 

GET PARAM 1 

LDQ- 

5,1 

GET PARAM 2 ADDRESS IN Q 

ADD- 

(ZERO),Q 

ADD PARAM 2 TO PARAM 1 

STA- 

1,1 

STORE ANSWER TO PASS IN A 
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5 

4 

3 
2 
1 

(I) + 0 

This example coding (immediately above) is used simply to illustrate how the 
program can access volatile for its temporary results. Of course, it would be 
inefficient to code the present example this way because the move and reloading 
are not necessary. Study all the addressing carefully. 


address of 
parameter 2 

address of 
parameter 1 

return 


A 


Q 


11.3.2 Reentrant Problem, AVG 

Following is the AVG program which computes an average. Rewrite the program 
as a non-destructive and reentrant subroutine. Assume that the calling program 
passes the number of words in A and the first word address in Q to the subroutine. 
The subroutine should pass the average back in A and the remainder in Q. Re- 
member that interrupts may not be inhibited more than 50 ps at any one time. 



NAM 

AVERAGE 


ENT 

AVG 


BZS 

OVFL(l) 

AVG 

0 

0 


ENQ 

9 


ENA 

0 


sov 

0 

LOOP 

ADD* 

X,Q 


SNO 

TEST-*-l 


RAO* 

OVFL 


AND 

=N$7FFF 

TEST 

SQZ 

AV-*-l 


INQ 

-1 


JMP* 

LOOP 

AV 

LDQ* 

OVFL 


ALS 

1 


LRS 

1 


DVI 

=N10 


JMP* 

(AVG) 


END 

AVG 
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11.4 MSOS REQUESTS MADE BY SYSTEM PROGRAMS 

Remember that all requests to MSOS simply put a desired action (such as a Write or 
Schedule) on a list (queue) and that the action may or may not be performed (depending 
on the rules) before control returns to the requestor. 

There are special considerations system programs (either core resident or mass 
memory resident) must make when making requests to the operating system. This is 
in addition to the considerations and rules jobs must follow. 

First, all protected programs must check a request after it is made to see if it was 
accepted. When control is returned to the requestor beneath the parameter string, Q 
will be positive if the request was accepted, negative if the request was rejected. For 






RTJ- 

($F4) , 

1 


NUM 

$1206 

^ schedule request 


ADC 

PGM ^ 

1 

CKQ 

SQP 

REQOK-*-! 


JMP* 

REQREJ 

REQOK 




In the above example when control is returned at CKQ, a skip is made to REQOK if, 
indeed, the request was accepted. Otherwise, (Q negative) a jump is made to REQREJ 
because the request is rejected. If a request is rejected, the program might either 
repeat the request at REQREJ, change the priority, or print an error message. Re- 
member that when a job made a request, the system would continually repeat the request 
until it was accepted, then return control to the program beneath the parameter string. 
However, all protected programs should check every request in the above fashion since 
there will be no other indication if a request is rejected. 

Even though a bit of Q is used to indicate acceptance or rejection of a request by the 
system, if the program were passing a parameter in Q, the full 16 -bit original Q is still 
passed intact. Only the upper bit has been changed when control comes back to the re- 
questor. 


11.4.1 Schedule 


A schedule request made by a system program would be coded the same as one 
made by a job except the requestor should check to see that it is accepted. Ex- 
amples would be: 


RTJ- 

($F4) 

NUM 

$1205 

ADC 

WRITE 

SQP 

OK-*-l 

JMP* 

REJ 


WRITE is in the scheduling program. It will be executed at priority 5. 
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MIPRO 

($F4) 

$1204 

MIPRO 

OK-*-l 

REJ 


MIPRO is external to the scheduling program and will be run at priority 4. It is 
core resident and not in the system directory. 

f- 

EXT 

f 

RTJ- 
NUM 
ADC 
SQP 
JMP* 

OK y 

Here MIPRO is in the system directory and will run at 4. The MIPRO program 
could be either core resident or mass memory resident. The scheduling program 
does not have to know where MIPRO is as the system will find it. 

There is an important consideration to make when deciding whether to schedule a 
program with the regular external form or whether to schedule it with the system 
directory form (having the program in the system directory). If it is undecided 
whether the scheduled program will be core resident or mass memory resident, 
use the system directory form as it will work in either case. The same logic 
would apply to a core resident program which may later be a mass memory pro- 
gram. Using the system directory form simply causes the system to have four 
more words of core (for the directory entry) and take a few microseconds longer 
to schedule but this can save miles of recoding. 


MIPRO 

($F4) 

$1204 

(MIPRO) 

OK-*-l 

REJ 


F 


EXT 

RTJ- 

NUM 

ADC 

SQP 

JMP* 


OK 


o 
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11. 4. 1. 1 Priorities (Schedule) 

The system program will be concerned with the priorities of the scheduled pro- 
grams. The software priorities run from 15 (highest) to 0 (lowest). The CP 
(completion priority) field in the request is the desired priority for the address 
scheduled. This means that scheduling is actually like jumping to an address and 
changing the running priority concurrently. 

If the priority in the schedule request is lower than or equal to the current running 
priority of the program making the request, the scheduled program will run after 
the current program is finished and the priority works down to it. It waits by 
priority in the scheduler stack with other scheduled programs. This is the way to 
set up things to be done after the current program exits. 

If the scheduled priority is higher than the running priority, a pseudo interrupt 
occurs immediately and the scheduled program is executed. Then control returns 
back to the requestor. 

Process programs usually run at priorities of 4, 5 and 6. Jobs run at 0 and 1. 
Other priorities are usually for the operating system and hardware interrupts. 

11.4.1.2 Rejects (Schedule) 

A scheduled request for a core resident system program which is not in the sys- 
tem directory would be rejected if there is no room in the scheduler stack (the 
queue for waiting scheduled programs) for the request parameters. If the request 
is for a program which is in the system directory and that program is already 
threaded on some thread, a reject would occur. This implies that the program 
has been scheduled (perhaps by some other program) and not yet finished. Pa- 
rameters for schedule requests for system directory programs are not transferred 
to the scheduler stack so a reject would not occur as a result of the scheduler 
stack being full. 

At this point it could be noted that relatively minor modifications to the system 
would be required to allow for a queue of requestors waiting to rerun a desired 
system directory program (for example, a mass memory program which is already 
in core). It would even be possible to allow that mass memory program to be re- 
entered by a higher priority interrupting program (in which case it would have to 
be reentrant). 

11. 4. 2 TIMER Request 

Since TIMER requests are simply delayed scheduler calls, they may be made by 
system programs with the same considerations as required for scheduler calls. 
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11. 4.3 I/O Requests 

The I/O requests (READ, WRITE, FREAD, F WRITE) must consider priorities 
when these requests are in protected programs o They must also check to see if 
the requests were accepted. The actual operation of what the requests do is the 
same as for jobs. 

The following is an F WRITE example: 



RTJ- 

($F4) 



NUM 

$0C76 

F WRITE, RP=7, CP=6 


ADC 

WROTE 

COMPLETION 


NUM 

0 



NUM 

$18FC 

ASCII MODE, STD. PRINT DEVICE 


NUM 

35 

35 WORDS 


ADC 

BUF 

BUFFER ADDRESS 


SQP 

OK-*-l 



JMP* 

REJ 


OK 

1 

T 


WROTE 


BUF(35) 


BUF 

BSS 



END 


11.4.3.1 Priorities (I/O) 

The request priority (RP=7 in example) has absolutely nothing to do with the 
running priority of the program. It is the priority of this request with respect to 
other requests for a logical unit number. In other words if there are RP=6 and 
RP=10 requests waiting to be written on the printer, the RP=7 requests will be 
threaded in between the 10 and the 6. Each logical unit has a queue of requests 
waiting for it and the driver will handle them sequentially by priority. When the 
write actually gets done is a fimction of the driver (program) priority and its re- 
lationship with the priority of the running program. For example, if the teletype 
driver runs at priority 10 and the program runs at priority 6, the driver will 
periodically interrupt the program to do the actual write operation. 

The completion priority in the requests (CP=6 in example) is related to the running 
priority of the program. It is like a schedule request for the completion address 
after the 1/ O is finished. In the example, if the running priority is 4, a pseudo 
interrupt will occur and the priority will be changed to 6 when the I/O is finished 
and the completion routine entered. 
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From the time the request is initiated until the time the I/O is completed, the 
thread word in the request will be non- zero. Here is an example of a program 
which rims at priority 4, initiates a request, and loops waiting for the request to 
be finished. 


THREAD 


LOOP 


COMPL 


RTJ- 

($F4) 


NUM 

$0CE0 

F WRITE, RP=14 

NUM 

0 

NO COMPLETION 

NUM 

0 

THREAD 

NUM 

$0804 

ASCII, OUT ON TTY 

NUM 

35 


ADC 

BUF 


SQP 

LOOP-*-l 

REQUEST ACCEPTED 

JMP* 

REQREJ 


LDA* 

THREAD 

THREAD ZERO YET? 

SAZ 

COMPL- *-l 

SKIP OUT; I/O DONE 

JMP* 

*-2 



Many programs have been coded this way; and this should not be done. Looping 
like this at any priority is going to slow down a system by locking out lower 
priorities. For example, if many process programs were coded this way, they 
could almost completely lock out job processing (which runs at 0 and 1), It would 
be much better to code the write with a completion address and jump to the dis- 
patcher to wait for the completion routine to be entered. 

It is important to control the priorities in a program which makes a number of l/O 
requests. Completion routines should be very short and should be at a higher 
priority than the rest of the program to cause a software interrupt in the program 
when l/O is complete. Completion priority could be lower than running priority 
if it is simply desired to check for errors at the end of the program or if it is 
desired for the programs handling the data to run lower. 


If a program is to run at priority 4 and all its I/O completion is to run at priority 
5, it would be necessary for each completion routine to schedule the priority back 
down to the program priority before initiating the next request. 
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EXT 

REJ, lOERR 



EQU 

T 

ADISP($EA) 



1 

RTJ- 

($F4) 



NUM 

$0875 

FREAD, CP=5 


ADC 

COMPRD 

COMPLETION 


NUM 

0 



NUM 

$1005 

ASCII, LUN 5=CR 


NUM 

40 

40-WORD BUFFER 


ADC 

BUF 



SQP 

REQOK 



JMP+ 

REJ 


REQOK 

JMP- 

(ADISP) 


COMPRD 

SQP 

SCHPRT 

PRIORITY HERE IS 5 


RTJ 

lOERR 


SCHPRT 

RTJ 

($F4) 



NUM 

$1204 

SCHEDULE, DOWN TO 4 


ADC 

PRINT 

PRINT IN SAME PGM 


JMP- 

(ADISP) 


PRINT 

RTJ- 

($F4) 

PRINT NOW AT PRIORITY 4 


NUM 

$0C05 

F WRITE, CP=5 


ADC 

COMPPR 



NUM 

0, $1004, 35 

LUN 4 (TTY), 35 WORDS 


ADC 

BUF 



I 


11.4.3.2 Rejects (l/O) 

An I/O request could be rejected if the request is already threaded (like if the 
program tried to start up that write again before it was finished) or if the system 
tries to schedule the driver and finds the scheduler stack full. (In that case the 
driver’s priority would be lower than the running priority of the program and that 
is not normal. ) 



11.4.3.3 


11.4.3.3 System Request Problem, THREAD 

The following example program runs at priority 12 and makes a Write request for 
the teletypewriter (logical unit 4) at priority 14. Since it has no completion ad- 
dress, it does not jump to the dispatcher to wait for the Write to be finished as 
control would not return to the program. Instead, it waits for the Write to be 
finished by looping on the thread word at LOOP. (The thread word was filled when 
the request was made and becomes zero again only when the driver has finished 


this request.) 

The driver runs at priority 10. 



RTJ- 

($F4) 



NUM 

$0CE0 

F WRITE, RP=14 


NUM 

0 

NO COMPLETION 

THREAD 

NUM 

0 

THREAD 


NUM 

$1004 

ASCII, OUT ON TTY 


NUM 

35 



ADC 

BUF 



SQP 

LOOP-*-l 



JMP* 

REQRE J 


LOOP 

LDA* 

THREAD 



SAZ 

COMPL- *-l 



JMP* 

*-2 


COMPL 





When will the write actually be done ? 

11. 4. 4 EXIT Requests 

All programs exit to the dispatcher. This is so the dispatcher can pick up the 
highest priority program waiting to be executed next, whether it is a previously 
interrupted program or a scheduled program. This is how the priority drops. 

The EXIT request made by an unprotected program generates a jump to the dis- 
patcher. A protected program may not use the EXIT request; it must code the 
jump to the dispatcher: 

f 


EQU 

ADISP($EA) 

( 

JMP- 

(ADISP) 

END 



11.4.5 SPACE and RELEASE 

There are two requests which only protected programs are allowed to make: Space 
and Release. These requests are used to get, and later release, core in the pro- 
tected area called allocatable core. Any unprotected program may access this 
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area and may use the space for anything it desires — to contain data or programs. 
The allocatable core area is divided into priority blocks (so that some core will 
always be available at the highest priorities). The sizes of the blocks at each 
priority are set up by the systems analysts at system initialization time. 

11. 4. 5. 1 SPACE Request 

Here is the format of the SPACE request: 

RTJ- ($F4) 



The Macro form for the SPACE request would be; 

SPACE n, compl, rp, cp, X 
RC is request code 10. Bit 8 is X bit. 

RP is priority of the block in which space is desired. 

CP is the priority of the completion address. 

COMPL is the completion address of where control will go after the space has 
been gotten. 

THREAD is the thread word, zero. 

Q is the Q register parameter passed back to the completion routine. Q will 
contain: 

address - of the space gotten, or 

$8000 - if no space will ever be available at this priority; this means 

that even if the background were swapped out there would still 
not be enough core to fill the request. 

N WORDS is the number of words of space requested. 

The address of the space would also be in core immediately preceding the space 
block which was acquired. 
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I 1 

I FWA I 



A swap would occur if necessary to get core under the following conditions: 

Request priority is greater than 3 
Completion priority is greater than 2 
Core is not already swapped 
No unprotected I/O is going on 
The minimum time between swaps is passed 

Otherwise, the request for space waits on a queue. 

The space request would only be rejected if it was already threaded, (i. e. , still 
involved in a previous operation. ) 

11.4.5.2 RELEASE Request 

After the program which requested the space is finished using it, it must release 
the space. This is done with a RELEASE request. The format of the release 
request is as follows: 



RTJ- 


($F4) 


15 

9 

8 

1 

0 

□ 

RC = 12 

n 

0 

ItJ 

FWA 


The Macro call for RELEASE is: 

RE LEAS fwa,t,x 

RC is request code 12; bit 8 is X bit. 
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^bit, bit 0, should be 0 if it is desired for control to return to the program 
(releasor) after the release is made. The 'f bit is set to 1 if control should go to 
the dispatcher instead. The release request is the only one which allows this 
choice of whether to come back to the program beneath the parameter string (as 
all other requests do) or to go to the dispatcher if this was the last thing to do. The 
’t’ bit will be used in coding mass memory programs. 

FWA is the address of the core to be released. It must be the correct address of 
the block or else no release will occur and there will be no error message. This 
is to provide flexibility so that a program which was coded to run on mass memory 
(in a later section) could be changed to be core resident without any changes or 
reassembly of the program. When it became core resident and tried to release 
its core, the core simply wouldn’t be released. 

The release request causes the space to be immediately given to any other space 
requestor waiting on the space queue before control returns to the releasor (or 
dispatcher) . 


An example of a space and release request could be: 




RTJ- 

($F4) 


1. 


NUM 

$1445 

RP=4, CP=5 



ADC 

COMPL 

COMPLETION ADDRESS 



NUM 

0 




NUM 

0 

ADDRESS COMES BACK HERE 



NUM 

$1000 

$1000 WORDS WANTED 

2. 


SQM 

REJ 

REQUEST REJECTED 



JMP- 

(AD ISP) 

WAIT FOR SPACE 

3. 

COMPL 

SQP 

GOTSP- *-l 

GOT SOME SPACE 



JMP* 

NOSPAC 

NO SPACE GOTTEN 

4. 

5. 

GOTSP 

STQ* 

[ 

REL+2 

ADDR. OF SPACE IN RELEASE 

6. 

REL 

1 

RTJ- 

($F4) 

GO RELEASE SPACE 

7. 


NUM 

$1800 


8. 


NUM 

0 

ADDRESS OF SPACE 

9. 


1 

j 





END 
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1 . 

2 . 

3. 


4. 


5. 

6 . 

7. 

8 . 


9. 


Space request, priority 4 block, completion priority 5 
Q is checked to see if request was not accepted. 

Completion address is entered when space is gotten or if there is no space. 
Q would be negative if no space was obtained. 

If space was obtained, Q contains the address of the block. Here it is stored 
in the release request. The address could also have been obtained later from 
word 3 of the space parameter list. 

Continue in program, using space. 

Release the space; program is finished using it. 

’t’ bit is not set, so control returns to the program after the release. 

The address of the block is here; it was placed here after the space was ob- 
tained. 

Continue in program. 


Note that the above program is not rimanywhere so it must be a core resident sys- 
tem program. The completion address in the space request is not relative. 


11. 5 CODING MASS MEMORY PROGRAMS 

All programs that are to be part of the System Library resident on mass memory must 
conform to special rules. All of the rules are logical when the inter-relationship of the 
program and the system is considered. The most important general consideration is to 
be sure the program gets to do ever 3 dhing it set out to do before it disappears. 


11.5.1 Modules in Library 


The programs are stored on mass memory in absolutized form. (The System 
Initializer put them there.) Each program - or a set of a program and its sub- 
routines together - is called a module and has a name unique to the module. The 
name must not appear as an entry point anywhere in the system. The name of 
the module must be in the system directory. Here is an example of two modules 
on mass memory: 


MIPRO 

Module 


SCAN 

Module 



(MIPRO is not an entry 
point. ) 
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MIPROis the program which handles manual interrupts to the process; the module 
is made up of the single program. SCAN is a module made up of a user process 
program SCANl audits subroutines SCAN2 and SCANS. These three programs go 
together and will always be together as a group when the module is brought into 
core for execution. 

It is possible for a mass memory module to contain a DATA block within it, ac- 
cessible only to the programs in that module. Any number of modules may contain 
separate DATA blocks, but there may be only one in each module. Here is an 
example of the SCAN module if it contained a DATA block: 


scans 


SCANS 


SCANl 


DATA 


( 


The programs in any module may use system COMMON, which is in highest core. 

11.5.2 Allocatable Core 

The area of core that the mass memory programs run in is called allocatable 
core. It is divided into priority blocks and the highest core area is available to 
the largest priority programs. A program to be run will be put in the smallest 
space it will fit in which is available to that priority. Note that this means a pro- 
gram may run at different places in allocatable core at different times. There is 
no dynamic relocation of the programs in allocatable core so as core spaces are 
released, they are saved for subsequent programs to be run in. 


Time 2 


Time 1 



area of allocatable core 
available to priority 4+ 


In the above example MIPRO may run in different places depending on the space 
available. 
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The systems analysts decide what priority area the program will run in (at system 
initialization time); so a program calling a mass memory program has no control 
over this. 


11. 5. 3 Scheduling the Mass Memory Program 

When it is desired to bring a mass memory program into core for execution, the 
calling program schedules it in. An example would be: 

EXT MIPRO 

SCHDLE (MIPRO), 4,0 

The system program MIPRO is scheduled in, to be executed at priority 4. As in 
all requests for system programs, MIPRO must be named external and must be in 
parentheses in the SCHDLE request. 

The name MIPRO is the name of the module in the system directory. This re- 
quest causes the system to obtain space in allocatable core to put the program in 
(by a SPACE request), then to read it in (by a mass memory READ request), then 
transfer control to it at its first core location. 

The calling program does not have to worry about all this; it s imply knows that 
scheduling it causes the program to come in to core and begin execution. The 
schedule request would be rejected if the program has already been scheduled (by 
another caller) and is still in the process of being brought into core. It could not 
be rejected from the scheduler stack being full because the parameters are not 
transferred to the stack. 

11. 5. 4 Form of Mass Memory Programs 

All mass memory programs have to be runanywhere, as has already been covered. 
This is because they are stored on the system library in absolute form and are 
run at different places in allocatable core, not where they were absolutized. 

Mass memory programs do not normally have to be reentrant because a program 
is usually brought into core each time it is called to be run. Minor modifications 
to the system would be required to allow a mass memory program which is in 
core to be reentered by a higher priority interrupting program; in that case it 
would have to be reentrant. 
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O 


Figure 27. Maps of Mass Memory Modules and Core Subroutines 
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11.5.5 Externals to Mass Memory Programs 

Externals in mass memory programs which reference locations which are core 
resident must be absolute. Externals which reference addresses in other mass 
memory programs (in the same module) must be relative. There must not be any 
externals which reference addresses in any other module. This is because one 
module does not know when another module is in core (or where it is) unless special 
links are provided to handle it. This means that any subroutine which several 
modules need would be either core resident or there would be a separate copy in 
each module that needs it. Another solution would be to put the subroutine in a 
separate module by itself and let routines needing it schedule it. 


11. 5. 6 Space 


Mass memory programs may release their own space. This is a good feature 
because it means that a program can schedule a mass memory program and then 
can forget about it after the schedule request has been accepted and exit knowing 
that the scheduled program will be executed at its priority. The mass memory 
program could pick up the address of where it is, as its first instruction (i. e.), 
and store it in the release request which would be the last instruction in the pro- 


gram. 




1. 

NAM 

SCNMSG 


2. SCNMSG 

NUM 

$C8FE 

LDA* *-l 


STA* 
9 . 

REL+2 


REL 

I 

RTJ- 

($F4) 


3. 

NUM 

$1801 

RELEASE REQ., TBIT SET 


NUM 

0 

ADDRESS TO BE RELEASED 


END 




core during execution: 


FWA 



Space gotten in SPACE 
request 
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1. Note that SCNMSG is not declared as an entry point since it is also the name 
of the module. 

2. Remember that the first word preceding Space in allocatable core obtained by 
a SPACE request contains the address of where that block of space is. The 
NUM $C8FE is to fake out the assembler and cause it to make a code as the 
first word of the program which will be a LDA* *-l. A LDA* *-l instruction 
would not have been assembled properly because it attempts to reference out- 
side of the program area relatively. Also remember that the first word of a 
mass memory module is executed so the NUM will not be treated as data. So, 
the $C8FE gets the address of the space occupied by the program into A. 

3. Note that in the release request the 't* bit (bit 0 in the first word of the pa- 
rameter string) is set to indicate to the system not to return to the program 
which made the release request after releasing the space. This bit would be 
necessary for a mass memory program releasing its own core. It makes 
sense because if control was returned to the program, there isn’t any program 
after the end. Or, even if there was some more program (such as a jump to 
the dispatcher), it may not be executed. Remember that when a release 
request is made, the space is allocated to any waiting requests before the 
return to the requestor. Therefore, the space may have been given away and 
may in fact contain another program or data; a return to the releasing program 
would cause a mess because it may not be there any more. 

If the mass memory module contains several subroutines, the NUM $C8FE 
would be the first instruction in the module and the RELEASE would be the 
last request made in the module. 

Mass memory programs should complete their I/O and their calls to any 
subroutines before exiting. This is because when they release their space 
and exit, any data buffers or completion addresses in the program may be 
lost as soon as the release request is made. 

11.5.7 Mass Memory Problem, MMPGM 

The following example program contains one error which could cause incorrect 
results. It is very subtle and difficult to locate. 

Assume that the assembly- language coding is runanywhere and correct. Look for 
an error which can occur during execution. The program runs at priority 4. The 
driver runs at priority 10. The completion routine runs at priority 6. 



11.5. 




NAM 

MMPGM 

MASS MEM PGM EXAMPLE 



ENT 

MMPGM 




EXT* 

REQREJ, lOERR 

MM EXTS IN SAME MODULE RELATIVE 



EXT 

CORSUB 

CORE RES SUB EXT ABSOLUTE 



EXT 

SYS PGM 

SYS DIR PGMS MUST BE EXTERNAL 

OOFA 

ADISP 

♦ 

EQU 

ADISP($FA) 



* 



FIRST INSTR OF MM PGM EXECUTABLE 

POOOO C8FE 

MMPGM 

NUM 

$C8FE 

PICK UP CORE ADDRESS OF MMPGM 



STA* 

RELf2 



* 

JMP* 

WRITE 


P0003 4D41 

MSGBUF 

ALF 

*,MASS MEMORY EXAMPLE* 


P0004 5353 
P0005 204D 
P0006 454D 
P0007 4F52 
P0008 5920 
P0009 4558 
POOOA 414D 
POOOB 504C 
POOOC 4520 

* 

WRITE FWRITE $FC, WROTE-*+l, MSGBUF-*+5, 10, A, 5, 6, 1, X 

POOOD 54F4 
POOOE 0D56 
POOOF OOOF 
POOlO 0000 
POOH 18FC 
P0012 OOOA 
P0013 7FF4 


P0014 0162 

SQP 

REQOK 

PROT PGMS MUST CHECK REQ ACC 

P0015 5800 X 

RTJ 

REQREJ 

GO HANDLE REJ;REL ADDRESSING 

P0016 7FFF X 




POOH 5400 X REQOK 

RTJ+ 

CORSUB 

ABS ADDRESSING TO CORE RES PGM 

P0018 7FFF X 




P0019 UFA 

JMP- 

(ADISP) 

NO MORE TO DO 


SCHDLE 

(SYSPGM),4,0 

SCH SYS DIR PGM, CORE OR MM 


POOIA 54F4 
POOIB 1204 


POOIC FFFF X 

♦ 


POOID 

0162 

WROTE 

SQP 

REL 

CHECK Q FOR lO ERRORS 

POOIE 

5800 X 


RTJ 

lOERR 

GO ANALYZE ERRORS 

POOIF 

7FFF 







REL 

RELEAS 

0, T,0 

0 WILL BE REPLACED W/ADDRESS 

P0020 

54F4 





P0021 

1801 





P0022 

0000 







♦ 



DO NOT RETURN TO PGM AFTER REL 




END 

MMPGM 


Map 






I 

OOFF 

MMPGM 

OOOOP 

ADISP OOFA 

MSGBUF 0003P WRITE OOODP 

REQOK 

0017F 

' WROTE 

OOIDP 

REL 0020P 

SYSPGM OOlCX CORSUB 0018X 

lOERR 

OOIFX REQREJ 

0016X 
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The following is a description of the concepts presented in MMPGM. Note that an 
entry point MMPGM is declared; therefore, the name of the module must be some- 
thing other than MMPGM. There are two relative externals, REQREJ and lOERR, 
which must be subroutines in this same module. There is one absolute external, 
CORSUB, which must be a core resident subroutine. 

POOOO - picks up the address of the core block MMPGM is located in, then 
stores it in the release request. 

POOOD - initiates an F WRITE from MSGBUF. RP=5 and CP=6. The X bit is 
set so WROTE- *+l and MSGBUF- *+5 calculate the correct distances 
from POQOE to the completion a ddre ss WROTE and the buffer MSGBUF 
and places them in POOOF and P0013. 


OOOE 

+000F 

00 ID WROTE 


OOOE 

+7FF4 

8002 

^ 

0003 MSGBUF 


P0014 - checks to see if the request was accepted. 

P0017 - jumps to execute CORSUB at running priority 4. 

P0019 - schedules a program in the system directory, SYSPGM, to be executed 
at priority 4 after completion of MMPGM. Note that SYSPGM must 
be named external and that the ( ) causes bit 15 to be setin POOlB. The 
program should have checked Q to see if the request was accepted. 

POOIC - the program has now run out of things to do, so it goes to the dis- 
patcher to await the write completion. 

POOID - after the write, the completion routine (running at priority 6) checks 
for errors. 

P0020 - the completion routine then releases core. The T bit is set so that 
after core is released, control will go to the dispatcher instead of 
returning to the program. 


11.6 EXTERNAL REFERENCES AND LINKAGE, SUMMARY 

It is desirable at this point to review the rules regarding externals among the various 
types of system programs. 

Core resident programs can make references to other core resident programs either 
relatively or absolutely. Since there is a choice, it is probably best to use absolute 
mode. Then if this program is ever made mass memory resident, its references to 
low core programs will be correct. 
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Core resident programs would not make any references to mass memory programs by 
way of externals. They would schedule the mass memory programs (which would be in 
the system directory). 

Mass memory programs are grouped together in modules. A module may be composed 
of a single program or several programs. Externals which reference core resident 
programs must be absolute. Externals which reference other programs in the same 
module must be relative. Mass memory programs may not reference any programs in 
another module by externals (they can schedule them in). 

A module has a name unique to it which is not an entry point anywhere in the system. 
This is the name in the system directory. Core resident programs can also be in the 
directory but only a few usually are. Any program which may at some later date be 
changed from core resident to mass memory resident (or vice versa) should be in the 
directory so that it can be scheduled by the system directory schedule request form. 
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Figure 28. 1700 Core Map 



- cannot reference any locations in 
other mass memory modules by 
way of externals 

Each "group" of mass memory programs loaded and linked together by one *YM control 
statement is called a mass memory module and has a name unique to the module. 
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12. 1 1721 PAPER TAPE READER 


The paper tape reader transcribes data to the lower 8 bits of the A Register at a rate 
of 350|eight-bit characters per second. The time between frames is 2. 857 milliseconds. 
These times qualify the 1721 to be grouped with the low speed package; equipment num- 
ber 1, station number 2. 


The Q Register will be in the following format when referencing the paper tape reader. 


Q 


15 14 13 12 11 10 9 8 
0 0 0 


0 1 


4 3 

0 0 


Equipment 1 


V. ^ / 

station 2 


2 1 0 

0 o| 

Director 

0 -► Data 

1 -► Status/Function 


The Q Register will contain either $00A0 or $00A1. 

LDQ =N$00A0 DATA 

LDQ =N$00A1 FUNCTION/STATUS 


12. 1. 1 PTR Functions 

The D portion dictates the operation to be performed in conjunction with the INP 
and OUT instructions. 

D = 1 FUNCTION (OUT) 

The programmer may issue the functions together with the exception of the clear 
controller and clear interrupt fimctions which must be issued separately. 

1 0 


I Clear Controller 
Clear Interrupts 

N$00A1 PTR for FUNC 

3 CLR INT, CLR CONT 

-1 


LDQ 

ENA 

OUT 
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The remaining functions may be issued jointly. 


A 


15 


6 5 4 3 2 1 0 



Stop Motion 


t 


♦ 

Data Interrupt Request 
Select Interrupt on Alarm 
Start Motion 


Data Interrupt - 

Bit 2 allows the programmer to instruct the 1721 to interrupt the 1700 when the 
holding register on the 1721 contains a frame of data ready for transfer. 

Alarm Interrupt - 

Bit 4 permits the paper tape reader to interrupt the computer if one of the following 
conditions arise: 

a) Paper Motion failure 

b) Lost data 

c) Power off 

Start Motion - 

Bit 5 starts the paper tape reader moving tape through the read station. Paper 
will continue to be moved through the read station until the motion is stopped or 
the reader runs out of paper. 

Stop Motion - 

Bit 6 stops the movement of the paper through the read station. The brakes on the 
1721 assure stopping before reaching the next frame. 

LDQ =N$00A1 PTR for FUNC 

LDA =NFUNC PLACE FUNCTION IN A 

NOP 

OUT -1 INITIATE DESIRED OPERATIONS 

The logic has been set up, therefore, the programmer needs only to bring the 
data into the computer. 

D = 0 DATA 

LDQ =N$00A0 PTR FOR DATA 

NOP 

INF -1 DATA IN LOW 8 BITS OF A 
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12.1.2 PTR Status 


12.1.2 


The programmer may monitor the operations of the paper tape reader by taking 
status. 

D = 1 STATUS (INP) 


LDQ =N$00A1 PTR FOR STATUS 

NOP 

INP -1 STATUS IN A 

The status bits are in the A Register. 

15 11 10 9876543210 

A mmmmmd 1 i 



Power On^ t 
Paper Motion Failure — ' 

Existence Code 

Protected 

Lost Data 

Alarm 

k 

k i 

i i 

k i 

; 

t 1 Ready 
1 Busy 

Interrupt 
Data 


Ready (Bit 0); Power is on and paper tape has been loaded into the reader. 
The preparations have been made known to the logic by pressing the READY switch 
on the paper tape reader console. The reader becomes Not Ready if a paper motion 
failure occurs or if the power is turned off. 

Busy (Mt 1): The paper tape reader is Busy if a Start Motion command has 
been issued and no Stop Motion command has followed. Motion stops on a Stop 
Motion command, a paper motion failure, or if the power is turned off. 

Interrupt (Bit 2); An interrupt condition exists. Other status bits must be ex- 
amined to determine the condition causing this interrupt. 

Data (Bit 3): The Data Hold register in the paper tape reader contains an 8-bit 
frame of data which is ready for transfer to the computer. Start Motion must be 
set to receive this status. The status drops when the Data Hold register is emp- 
tied by transfer to the computer. 

Alarm (Bit 5); At least one of the following conditions exists in the paper tape 
reader: (1) paper motion failure (bit A9), (2) lost data (bitA6), or (3) power off 
(bit AlO is 'O’). 

Lost Data (Bit 6) : When in interrupt on Data mode, paper motion continues after 
the Data Hold register is full. If the data is not transferred to the computer before 
the next frame appears, a lost data status occurs to show aframe has been passed. 
The time between frames is 2.857 milliseconds. The status drops when a clear 
controller command is sent. Lost data stops tape motion. 
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Protected (Bit 7); The PROGRAM PROTECT switch is on. This switch on the 
paper tape reader works in conjunction with the PROGRAM PROTECT switch on 
the computer. If the switch on the computer is off and the PROGRAM PROTECT 
switch of the peripheral device is on, no action is taken but the status bit is set to 
indicate the switch is on. If the switch on the computer is set, all rules of pro- 
gram protection apply. The paper tape reader in this condition only accepts pro- 
tected instructions. 

Existence Code (Bit 8); The paper tape reader is attached. If the bit is a the 
reader is missing from the particular computer system. 

Paper Motion Failure (Bit 9)^ No change in the feed hole circuit has occurred 
for 40 milliseconds while trying to read. The paper motion failure causes the 
reader to become Not Ready; it can only be made ready by pushing the READY 
switch or by a Clear Controller command. It is considered an illegal operation to 
send any other function code to the reader or a read command until the READY 
switch has been pressed or a Clear Controller has been issued. 

Power On (Bit 10); Power to the reader is on. If this bit is a ’O’, power is off. 
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12.1.3 Example 

The following is a test program for the 1721 paper tape reader. It inputs data, 
beginning with the first nonzero frame, until a zero word is encountered, at which 
time data input stops. The data is stored in the consecutive locations beginning 
after the end of the program. 

The controller should be cleared from the console before the program begins, as 
the clear controller function cannot be sent with the start motion function at line 4. 
The stop switch should be set so the program will stop after reading the tape. 
After it stops, if the switch is set to RUN, the tape which was just read will exe- 
cute (assuming it contained an absolutized program). 

1721 PTR - AUG '68 
USDA 

*CLEAR CONTROLLER FROM CONSOLE - CANNOT START MOTION & CLEAR CONTROL- 
LER IN SAME FUNCTION 

The following is a test routine for the 1711 teletype. It outputs an 11-word mes- 
sage from the buffer GET. The controller is cleared in a separate function before 
anew function is selected. Write mode is selected because Read mode is in 
effect after the clear controller function. 


■ 000-1- 
0002 

pfiono 

pnep 

QJART 

— MAM 

ENT 
t_ no 

BOOT-S-TRAP 

START 

=M<RA1 

PTR DTR PTTNr 

nnna 

POOOl 

prmn? 

OOAl 
n APn 


FMA 

<R?fl 

START MOTION 

0005 

P0003 

pnrm4 

03FE 

nnpF 


OUT 

TMO 

-1 

-1 

SPT T^ REAP 

0007 

OOfiR 

P0005 

pnOR^^ 

OBOO 

(tppF 

LOAHl 

NOP 

IMP 

-1 

INPUT LEADER 

0009 

n 

P0007 

DfinnR 

0113 
1 «Fn 


SAN 

'MP* 

3 

LOAni 


0011 
nn 1 p 

P0009 
p n n n A 

OBOO 

n?pp 

pnAp? 

NOP 

IMP 

-1 

TiMPTTT FRAME 

0013 

001^ 

POOOB 

pf)0(ir 

0FC8 
f)pn n 


ALS 

MOP 

8 

SHIFT TO PACK 

0015 
nm ^ 

POOOD 

pnnep 

02FE 

4 


INP 

STA* 

-1 

( AnnoFQ^ 

INPUT NEXT FRAME 

<3TnPT? 

0017 
oni p 

POOOF 
POni n 

0103 

pHd? 


SAZ 

PAO* 

EXIT-*-l 

Aopppc; 

EXIT ON ZERO WORD 

0019 

nn?n 

POOH 
pnm ? 

18F8 
nn 1 4 p 

Anr»c?F<; 

JMP» 

Apr 

LOAD2 

GO GET NEXT WORD 

T r> Ar> AT’ T>4r>i/i 

0021 
— 0022 

P0013 

0000 

EXIT 

NUM 

EMH 

$0 

START 

ZERO FOR SLS 


4 S-T-ART Oiianp LQADl OnOftR-LOAD? OLflOAP A nOR F S OOIPP 

EXIT 0013P 


1725 


BOOTST 


where bootstrap loadftri. 
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12.2 1723 PAPER TAPE PUNCH 


The punch is grouped with Control Data’s low speed package. The punch is a character 
device. It accepts the lower 8 bits of the A Register as data. These 8 bits may be ASCII 
codes or binary. 

The punch is addressed as Equipment 1, Station 4. 

15 11 10 9876543210 

F 

Q 


0 0 0 1 


10 0 


Equipment 1 Station 4 


Director 

0-*-Data 

1 -►Function/ Status 


LDQ 

LDQ 


=N$00C0 

=N$00C1 


PTP, DATA 

PTP, FUNC/STATUS 


12. 2. 1 PTP Functions 

The programmer may direct the operations and interrupt selections of the Punch 
via the Director function. The clear interrupt and clear controller function may 
be issued together but should not be issued with the other functions. 


15 


0 


I CLR Controller 
CLR INT 


LDQ 

ENA 

OUT 


=N$00C1 

3 

-1 


PTP, FUNC 


The remaining functions may be issued together. 

15 6543210 


Stop t t t Data Interrupt 
Motion J I Alarm Interrupt 
Start Motion 


LDQ 

=N$00C1 

PTP, FUNC 

LDA 

=NFUNC 

FUNCTIONS 

OUT 

-1 

INITIATE FUNCTIONS 
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12.2.2 PTP Status 


The programmer may status the Paper Tape Punch by setting the Director bit to 
a and issuing an INP instruction. 


LDQ 

NOP 

=N$00C1 

PTP, STATUS 

INP 

-1 

STATUS TO A 


15 


12 11 10 9876543210 


Tape Supply Low 

Power On 


4 4 4 4 


Tape Break 

Existence Code - 
Protected 


4 4 4^1 

I Ready 

Busy 

Interrupt 

Data 


Alarm 


Ready (Bit 0): The paper tape punch is Ready when its power is on, tape has been 
loaded, and the READY switch on the station console has been pressed. The 
punch becomes NOT READY if tape break occurs or if power is turned off. 

Busy (Bit 1): The punch is Busy if a Start Motion is in effect or until the punch 
has finished processing the data in the Data Hold register. 

Interrupt (Bit 2) ; An interrupt condition exists. Other bits can be monitored to 
determine if one or more of the selected interrupts has occurred. 

Data (Bit 3): The 8 bits of data in the Data Hold register of the punch have been 
punched and the new data may be received from the computer. The data status 
drops when a transfer from the computer is made. 

Alarm (Bit 5): This status indicates that one of the following conditions has arisen: 

a. Tape Break 

b. Power off 

c. Tape low 

The status drops when the condition is corrected. 

Protected (Bit 7): The PROGRAM PROTECT switch on the peripheral equipment 
is set. The status bit only indicates that the switch is set; it does not show if a 
program protect violation occurred. If the PROGRAM PROTECT switch on the 
computer is on, the punch does not accept commands which are not protected. All 
rules of program protection apply. 
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Existence Code (Bit 8); A zero setting acknowledges that the paper tape punch is 
attached. If the bit is a ’1’, the punch is missing from the particular computer 
system. 

Tape Break (Bit 9): The tape break status bit is set if the punch supply tape has 
broken or run out and approximately 2 inches of tape remain. ' If the tape supply 
low bit is ignored, it results eventually in the Tape Break condition as the supply 
of tape is exhausted. The Tape Break condition causes the punch to become Not 
Ready. It can only be made Ready by loading paper tape and pressing the READY 
switch. However, it is still able to receive the Clear Controller and Clear Inter- 
rupts function codes so that the Interrupt signal (if Interrupt on Alarm was selected) 
can be dropped. It is considered an illegal operation to send any other function 
code or a Write signal until the READY switch has been pressed. 

Power On (Bit 10): The power to the punch is on. If this bit is not a the 
power is off and an Alarm interrupt may be generated. 

Tape Supply Low (Bit 11); The available supply of tape remaining to be punched is 
limited. 
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12.2.3 PTP Example Program 


0001 




NAM 

PUNCH 


0002 




ENT 

START 


0003 

POOOO 

0019 


BZS 

AA(25) 

- SET BUFFER TO 1»S 

0004 


00 lA P 


EQU 

BB(AA+25)^»^^ 

FROM CONSOLE 

0005 


OOEA 


EQU 

ADISP($FA) ^ 

■^NOTE THAT 26 WORDS WIDL 

0006 


OOCl 


EQU 

PUNCH ($00C1) 

BE OUTPUT, NOT 25 

0007 




EXT 

ERROR, DISP 


0008 

P0019 

0002 


BSS 

TEMP (2) 

RESERVED FOR BLOCK SIZE 

0009 

P0018 

0001 


BZS 

CKS(l) 


0010 

POOIC 

COOO 

START 

LDA 

=XAA 

FWA 


POOID 

0000 P 





0011 

POO IE 

9000 


SUB 

=XBB 

LWA 


POOIF 

001 A P 





0012 

P0020 

0113 


SAN 

OK-*-l 

IF UNEQUAL, ALLj IS FINE 

0013 

P0021 

1400 X 


JMP+ 

ERROR 

CONTAINS SIZE OF BLOCK 


P0022 

7FFF X 





0014 

P0023 

OBOO 


NOP 



0015 

P0024 

68F5 

OK 

STA* 

TEMP+1 

BLOCK SIZE COMPL 

0016 

P0025 

0864 


TCA 

A 

COMPLEMENT BLOCK SIZE 

0017 

P0026 

68F2 


STA* 

TEMP 

BLOCK SIZE A 

0018 

P0027 

COOO 


LDA 

=X$7FFF-50 



P0028 

7FCD 





0019 

P0029 

60FF 


STA- 

I 

I EQUALS COUNTER FOR LEADER 

0020 

P002A 

EOOO 


ldq 

=XPUNCH 

PREPARE PUNCH TO RECEIV 


P002B 

OOCl 





0021 

P002C 

OAOl 


ENA 

+1 

CLEAR CQNTROLLER 

0022 

P002D 

03 FE 


OUT 

-1 


0023 

P002E 

0A20 


ENA 

$20 


0024 

P002F 

03FE 


OUT 

-1 


0025 

P0030 

ODFE 


INQ 

-1 

PREPARE PUNCH FOR DATA 

0026 

P0031 

0844 


CLR 

A 


0027 

P0032 

03FE 

LOOPl 

OUT 

-1 

JUMP ON SELF UNTIL OUT 

0028 

P0033 

DOFF 


RAO- 

I 

UPDATE LEADER COUNT 

0029 

P0034 

OlAl 


SOV 

NEXT-*-l 

WHEN 1=8000, 50 BLANKS 

0030 

P0035 

18FC 


JMP* 

LOOPl 

KEEP OUTPUTTING BLANK L 

0031 

P0036 

C8E3 

NEXT 

LDA* 

TEMP+1 

COMPLEMENT OF BLOCK SIZE- 

0032 

P0037 

0FC8 


ALS 

8 

HIGH ORDER BITS PUNCHED FIRST 

0033 

P0038 

OBOO 


NOP 



0034 

P0039 

03FE 


OUT 

-1 


0035 

P003A 

0FC8 


ALS 

8 

LOW ORDER BITS SECOND 

0036 

P003B 

OBOO 


NOP 



0037 

P003C 

03FE 


OUT 

-1 

SIZE OF BLOCK NOW ON TAPE 

0038 

P003D 

0844 


CLR 

A 


0039 

P003E 

60FF 


STA- 

I 

ZERO OUT THE INDEX I 

0040 

P003F 

C500 

LOOP2 

LDA+ 

AA,I 

PLACE FIRST WORD OF DATA IN 


P0040 

0000 P 





0041 

P0041 

88D9 


[add* 

CKS 

CHECKSUM 

0042 

P0042 

68D8 


! STA* 

CKS 
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0043 

P0043 

C500 


LDA+ 

AA,I 

ORIGINAL DATA IN A 


P0044 

0000 P 





0044 

P0045 

0FC8 


ALS 8 



0045 

P0046 

OBOO 


NOP 



0046 

P0047 

03FE 


OUT 

-1 

OUTPUT FIRST CH. 

0047 

P0048 

0FC8 


ALS 

8 


0048 

P0049 

0800 


NOP 






Could 




0049 

P004A 

03FE 

compute 

OUT 

-1 

OUTPUT SECOND CH. 

0050 

P004B 

DOFF 

CKSUM 

*’rao- 

I 

UPDATE INDEX 

0051 

P004C 

COFF 

here 

LDA- 

I 

PLACE UPDATE IN A 

0052 

P004D 

98CB 


SUB* 

TEMP 


0053 

P004E 

0101 


SAZ 

SUM-*-l 

BLOCK IS PUNCHED 

0054 

P004F 

18EF 


JMP* 

LOOP2 


0055 

P0050 

C8CA 

SUM 

LDA* 

CKS 


0056 

P0051 

0FC8 


ALS 

8 


0057 

P0052 

OBOO 


NOP 



0058 

P0053 

03FE 


OUT 

-1 

FIRST CH. OUT 

0059 

P0054 

0FC8 


ALS 

8 


0060 

P0055 

OBOO 


NOP 



0061 

P0056 

03FE 

sov 0 — 

►OUT 

-1 

CHECKSUM ON PAPER TAPE 

0062 

P0057 

COOO 


LDA 

=X$7FFF-50 

PREPARE FOR END LEAD 


P0058 

7FCD 





0063 

P0059 

60FF 


STA- 

I 

INITIALIZE INDEX I 

0064 

P005A 

0844 


CLR 

A 


0065 

P005B 

68BF 


STA* 

CKS 


0066 

P005C 

03 FE 

LOOP3 

OUT 

-1 

OUTPUT BLANK LEADER 

0067 

P005D 

DOFF 


RAO- 

I 

UPDATE INDEX 

0068 

P005E 

OlAl 


SOV 

DONE-+-1 

IF OVERFLOW FINISHED 

0069 

P005F 

18FC 


JMP* 

LOOP3 


0070 

P0060 

ODOl 

DONE 

INQ 

1 

PREPARE PTP FOR FUNCTION 

0071 

P0061 

OAOl 


ENA 

1 


0072 

P0062 

03FE 


OUT 

-1 

CLEAR CONTROLLER 

0073 

P0063 

COOO 


LDA 

=N$40 

STOP MOTION 


P0064 

C040 





0074 

P0065 

03FE 


OUT 

-1 

OUTPUT FUNCTION 

0075 

P0066 

14EA 


JMP- 

(ADISP) 


0076 




END 

START 



I 

OOFF 

START 

OOlCP 

AA 

OOOOP BB 

OOIAP 

ADISP 

OOEA 

PUNCH 

OOCl 

TEMP 

0019P 

CKS 

OOIBP OK 

0024P 

LOOPl 

0032P 

NEXT 

0036P 

LOOP2 

003FP 

SUM 

0050P LOOPS 

005CP 

DONE 

0060P 

DISP 

7FFFX 

ERROR 

0022X 








f COUNT 

SUM OF ALL DATA WORDS, DISREGARDING OVERFLOW 
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12.3 1711 TELETYPEWRITER 

The 1711 Telet 3 ^e may send and receive information. The data transmission to or 
from the 1711 takes 100 milliseconds. 


The Teletype is one of three devices composing the low speed package which is always 
Equipment Number 1. All interrupts generated by the teletype shall be processed via 
line 1 interrupts. 

TheQ Register will contain $0091 or $0090 when communicating with the teletype. Break 
this word down into Binary, and we have Equipment 1, Station 1. 


W 


E 


D 


Q 


Equipment 1 Station 1 Data 0 

Function or Status 1 


The D portion denotes the transfer of data when set to zero. All data transmissions will 
be to and from the lower 8 bits of the A Register. The characters will be transferred 
in ASCII codes, one character at a time. The directional flow of the data will be governed 
by the INP and OUT instructions. 


LDQ 

=N$0090 

TTY FOR DATA 

NOP 

INP 

-1 

READ DATA INTO A 

LDQ 

=N$0090 

TTY FOR DATA 

LDA 

BUF 

PUT DATA IN A 

NOP 

OUT 

-1 

WRITE DATA ON TTY 


12. 3. 1 TTY Functions 


The D portion indicates a function or a status when set to a 1. A function is indi- 
cated by issuing an OUT instruction with A preset to the function. 


LDQ 

=N$0091 

TTY FOR FUNC OR STATUS 

LDA 

FUNC 

PLACE FUNCTION IN A 

NOP 

OUT 

-1 

OUTPUT A FUNCTION 


1 0 



I Chn CONT 
CLR INT 


The clear controller and clear interrupt functions must be sent to the telet 3 qDe 
prior to selecting other functions. 
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A 



10 987 543210 



Select Read Mode^ t 
Select Write Mode ' 

Select Interrupt on Alarm 

Select Interrupts on End of Transmission 

(EOT Key) 


^ ^Clear Controller 
Clear Interrupts 
Data Interrupt Request 


The 1711 provides the capability of selecting three interrupts; DATA, ALARM, 
and END OF TRANSMISSION (EOT), The DATA interrupt will occur when the 
teletype is prepared to send or receive data. The ALARM interrupt will be 
generated if data has been lost or if the teletype goes from RE ADY to NOT READY. 
The END OF TRANSMISSION interrupt will occur whenever the EOT key on the 
console of the teletype has been pressed. None of these conditions will generate 
an interrupt imless the programmer has selected them. 


The motor will be started on the 1711 by an output of a dummy character - to the 
teletype. 


12. 3. 2 TTY Status 

Status will be sent to the A Register from the teletype with an INP instruction. 

LDQ =N$0091 TTY FOR STATUS OR FUNC 

NOP 

INP -1 INPUT STATUS TO A 


The A Register will contain the status and the programmer may examine it to 
determine the next procedure he wishes to follow. 


15 


12 11 10 9 8 7 6 5 4 3 2 1 0 


t ^ ^ 

Manual Interrupt' 

Motor On — 


Read Mode — I 


4 4 A 4 4 i 4 

I I Ready 

Busy 
Interrupt 
Lost Data -• Data 

Alarm End of Transmission 


Ready (AO is 1); If this bit is set in the A Register, the Power switch on the con- 
sole of the teletypewriter is in the ON-LINE position and the motor is on. 

Busy (A1 is 1); If this bit is set, one or more of the following conditions exist: 

a) The controller is in Read mode and is in the process of receiving a char- 
acter from the teletypewriter or the Data Hold register contains data for 
transfer to the computer. The Busy status drops upon completion of the 
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transfer to the computer if data has not been lost. If data has been lost, 
the controller requires 200 milliseconds to stop the teletypewriter and 
remains Busy all this time. 

b) Write mode and the Data Hold register contains data and is in the process 
of transferring it to the telet 3 q)ewriter. Busy drops upon completion of the 
transfer. 

c) Either mode and the controller is in the process of starting the motor in 
the teletypewriter. In Write mode output of a character starts the motor 
and this character is lost. In Read mode, the BREAK key must be pressed 
to start the motor. 

Interrupt (A2 is 1); An interrupt condition exists. Other bits must be monitored 
to determine the condition causing this interrupt. 

Data (A3 is 1) : An interrupt is generated and this status bit is a 1 under the fol- 
lowing conditions: 

a) Read mode and the Data Hold register contains data for transfer to the 
computer. The status drops upon completion of a Read. 

b) Write mode and the controller is ready to accept another Write from the 
computer. The status drops upon completion of the Write. 

End of Transmission (A4 is 1): The Data Hold register contains the End of Trans- 
mission code. This code is generated by pressing the EOT key on the keyboard 
of the teletypewriter. The end of transmission status drops upon the completion 
of the next Write or Read. 

Alarm (A5 is 1) : The teletypewriter is not in a Ready state or has lost data. 

Lost Data (A6 is 1) : The controller was not serviced by the computer before a 
new character was sent by the teletypewriter. The keyboard and tape transmitter 
are locked out. The status bit indicates a Lost Data condition, and a Busy status 
indicates that the process of stopping the teletypewriter is in progress. Data held 
in the Data Hold register is not disturbed, but the incoming data is ignored. The 
lost data status can be cleared by a Clear Controller or a Select Write Mode com- 
mand. These two functions are rejected while the controller is stopping the tele- 
typewriter. The Select Write mode command must be preceded by a Read operation 
to clear the Data Hold register. After the teletypewriter has stopped, the computer 
may do an Output operation to notify the controller of the Error condition. 

Read Mode (A9 is 1): If this bit is a 1, the controller is conditioned for an Input 
operation from the teletypewriter. Read mode is automatically in effect after a 
clear controller function has been issued. 
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Motor On (AlO is 1): The motor of the teletypewriter is on. The presence of this 
bit indicates that the teletypewriter motor is on and up to speed. 

a) Write mode: Motor starts with the output of a character. Two-second 
delay occurs between output of the character and this status bit being set 
to allow the motor to get up to speed. 

b) Read mode: Press the BREAK key to turn on the motor. Two-second 
delay, also occurs between the action of the BREAK key and the status bit 
being set to allow the motor to get up to speed. 

Manual Interrupt (All is 1): The manual interrupt button on the teletype has been 
pressed. 

Example: 

The following is a test routine for the 1711 teletype. It outputs an 11-word mes- 
sage from the buffer GET. The controller is cleared in a separate function 
before a new function is selected. Write mode is selected because Read mode 
is in effect after the clear controller function. 
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o 

12. 3. 3 TTY Example Program 



WA44 

0002 POOOO 504C GET ALF 

POQOl - 45 A- 1 

P0002 5345 

POO 04 4E50 

p0 . 0 05 -5 bb A 

P0006 2059 

POOP 7 4F55 

P0008 5220 

p .^ )D 0 . 9 .^ 3 .. 4T : 

POOOA ^f445 


0 0 0 _ 3 P - 0 - 0 OB — 0 8 - 4 -4 C4R 

0004 POOOC 60FF STA- 

0 . (K P 5 ■ p . ^O[j __g O . (U J UTO- 

POOOE 0091 

0006 POQOF 0AQ3 &N A - 

0007 POOlO 03FE OUT 

0008 poon CO 0 0 uoa - 

P0012 0100 

0 00 - 9 - P0 4 )13- a U(TQ (40P- 

0010 P0014 03FE OUT 

00 - 1 - 1 P4 P 015 — O DF -E 

0012 P0016 OBOO NOP 

0 0 - 1 - 3 R ^ )17 0 3KE OUX- 

0014 P0018 C9E7 LOOP LDA^*^ 

0 015 P0 - 019-- a FC8 A1= S - 

0016 pool A 0 80 0 NOP 

Q..Q-L 7 . .P.lX0 18 -aTF-£ QiJT . 

0018 POOIC OFCB ALS 

0 0. 1 -9 P ..QX)U) OB 0 .0 NO.P— 

0020 POOIE 03FE OUT 

0 021 POP I F . D O F F RAO- 

0022 P0020 COFF LDA- 

0023 P0021 09F4 T-N A .. 

0024 P0022 0101 SAZ 

002-5 PU 023 -IdEA JMB± 

0026 P0024 0000 DONE 0 

0 0 2-7 ENO- 


- TYPE-OUT 

11»PLEASE INPUT YOUR CODE 

N 

Message 


A 

I 

.=N $ DD 9- I TTY DI - R E - UNC 

S3 CTR C ONTR TNT 

-1 

=N$ - 10 -Q W^Rt T E MO D E 


-1 

-O WRI -TE- DATA FUNC 

^ SEND DUMMY CHAR 

get » I OUTPUT DATA 

^ 


8 


-1 

I 

I 



DONE-*^-l 

LOO P 

0 


i OQF p: 0 0 0 0 P ■ G O OP 0018P - DD M E 002 -4R 


o 


12-15 



12.3.3 


Tj^ewriter Printout 


PP 

* 


MI 

*K,I5 

J 

*p 


J 

*ASSEM 

L,03 FAILED 01 

ACTION 

CU 

L, 03 FAILED 01 

ACTION 

CU 

L, 03 FAILED 01 
ACTION 
CU 
J 

*p 

J 

*L,8 

J 

PLEASE INPUT YOUR CODE 


Output from program 



USDA - August 1968 
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12.4 1713 TELETYPEWRITER 

The 1713 is composed of a keyboard, printer, paper tape reader, and a paper tape 
punch, each accessible by the computer. The 1713 is grouped with the low speed 
package, equipment number 1, station number 1. The Q Register will be in the following 
format when referencing the 1713. 


Q 


15 

11 

10 

9 

8 

7 

6 

5 

4 

3 

2 

1 

0 

0 0 

0 0 0 

0 

0 

0 

1 

0 

0 

1 

0 

0 

0 



Equipment 1 Station 1 0 = Data 

1 = Function/ Status 


LDQ =N$0090 SEL TTY, DATA 

LDQ =N$0091 SEL TTY, STATUS OR FUNCTION 

The programmer has the option of selecting the reader, punch, printer or keyboard. All 
four units may be used together or separately. The selection is made by setting an 
appropriate bit in the function word. 


A 


Bit 14 


15 14 13 12 11 10 


t t 

I Select Keyboard Mode 
Select Keyboard- Tape Mode 
Select Tape Mode 
Select Tape- To- Tape Send Mode 
Select Tape- To- Tape Receive Mode 

Connects the punch to the controller leaving the keyboard and reader inactive. 


Bit 13 — ► Connects the reader only to the controller. 

Bit 12 — ► Connects the page printer and reader to the controller. The keyboard and 
punch are connected together as an off-line tape preparation device. Read 
operations transfer information from the paper tape reader to the controller 
and the page printer. Write operations transfer information to the page 
printer. Simultaneously, a new tape can be prepared from keyboard entries. 

Bit 11 — ► Connects the keyboard, page printer, reader and punch to the controller. A 
character struck on the keyboard or sent from the reader is printed, punched 
and transmitted. A character sent to the 1713 is printed and punched. 

Bit 10 — ► Connects the keyboard and printer to the controller which act as a send/receive 
page printer. The paper tape units are inactive in this mode. 
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The 1713 accepts the lower eight bits of the A Register as data and sends eight bits of 
data to the A Register. All codes going to the page printer must be eight bit ASCII 
codes. The data transfer rate is 100 milliseconds per character. 


12.4.1 1713 Functions 

Prior to selecting a mode, the controller and interrupts maybe cleared by issuing 
a function to the 1713. 

15 10 

^ I I 


I CLR Controller 
CLR Interrupts 


LDQ 

=N$91 

SEL TTY, FUNCTION 

ENA 

$3 

CLR CONT & CLR INT 

OUT 

-1 



Interrupts may be selected by setting the following bits. 

15 4 3 2 

t t ^ 

I Data INT Request 
End of Operation Interrupt 
Alarm Interrupt Request 

Bit 2 ► Allows the 1713 to interrupt the computer whenever the holding register 

is ready to send or receive data. 

Bit 3 ► Notifies the 1713 to interrupt the computer whenever an operation is 

completed. 

Bit 4 ► Provides for an interrupt whenever an alarm condition arises. Alarm 

conditions: 

1. 1713 becomes NOT READY 

2. LOST DATA 

3. Out of Tape 

LDQ =N$91 SEL TTY, FUNCTION 

LDA =N$1C INT ON DATA, ALARM, EOF 

NOP 

OUT -1 
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The operating mode, READ or WRITE, is selected by setting a bit in the function 
word. 

15 9 8 

A 


I Select Write Mode 
Select Read Mode 


LDQ 

=N$91 

SEL TTY, FUNCTION 

LDQ 

NOP 

=N$100 

WRITE MODE 

OUT 

-1 


LDQ 

=N$91 

SEL TTY, FUNCTION 

LDA 

NOP 

=N$200 

READ MODE 

OUT 

-1 



When running in Tape- To- Tape Send Mode, the program must issue a START 
TAPE MOTION function. When reading data from the reader a start motion function 
must be issued after each character. 

15 5 


4 

start Tape Motion 


LDQ 

=N$91 

SEL TTY, 1 FUNCTION 

LDA 

=N$2220 

TAPE SEND, READ, START TAPE 



MOTION 

NOP 



OUT 

-1 



All of the functions mav be issued together with the exception of the clear con- 
troller and clear interrupt functions which must be issued separately. 


12.4.2 1713 Status 


Status may be taken on the 1713 at any time. 


LDQ 

NOP 

=N$91 

SEL TTY, STATUS 

INP 

-1 

STATUS IN A 
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11 10 9 


6 5 4 3 2 1 0 


Manual INT-i 

Motor On- 
Read Mode 


Lost Data 


Ready 


I Interrupt 
Data 

End of Operation 
Alarm 


When the corresponding bit is a 1, the condition exists. 


READY 


BUSY ► 

INTERRUPT 


DATA 


The 1713 is capable of performing operations and ac- 
cepting functions. 

The 1713 is in the process of performing an operation. 
An interrupt has been generated. 

The holding register in the 1713 is prepared to send or 
receive data. 


END OF OPERATION — ► The 1713 has completed an operation. 


ALARM 

LOST DATA 


READ MODE 


MOTOR ON 


MANUAL INTERRUPT 


An alarm condition exists in the 1713. 

The 1713 had data in the holding register which was not 
picked up by the computer before another character was 
read into the register. 

The 1713 is in a read mode. If this bit were not set, 
the write mode would be in effect. 

The 1713 motor is on. If this bit were not set, the 
motor is not on. 

■The manual interrupt button on the 1713 has been 
pressed. 


12.4.3 Example Program, 1713 TTY 

The following program generates 10 frames of data in the A Register and punches 
them on paper tape. It then stops and waits for the tape to be put in the reader. 
It reads 20 frames and stores them in a buffer. Program read can be checked by 
sweeping the buffer. 
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The STOP Switch should be set before the program is run. 


0002 




ENT 

PT1713 


0003 

POOOO 

000 0 

PTl 71 3 

0 

0 


0004 

POOOl 

EOOO 


EDO 

=N$91 

TTY, FUNC/STATUS 


p n n n p 

nnui 





0005 

P0003 

0A0 3 


ENA 

$3 

CLR CONTR, CLR INT 

0006 

P 0 0 0 4 

03FE 


OUT 

-1 


0007 

P0005 

02FE 


INP 

-1 

INP STATUS 

0008 

p 0 0 0 6 

OKCF 


ALS 

18 

ready PTT 

0009 

P0007 

0131 


SAM 

1 

SKIP WHEN READY 

nn 1 n 

pnnnA 

1 HFT 


IMP«- 


nri T.TA TT* T-TT T DCAnV 

0011 

P0009 
pnnn A 

cooo 

41 Pfl 


LDA 

=N$4120 

TTR, WRITE, START MOTION 

0012 

POOOB 

OBOO 


NOP 



nn n 

POOor 

<I3PF 


ni IT 

-1 


0014 

POOOf) 

ODFE 


INQ 

-1 

PREPARE TO SEND DATA 

nn 1 c; 

pnnnF 

8841 


RT 1* 

1 FAHFR 

rn nTTT'PTTT' TTTAr»T7T5 

0016 

POOOF 

OAOF 

WRITE 

ENA 

3>F 

DATA $F IN A 

nni 7 

Pom 0 

0 3FF 


OUT 

-1 

OUTPUT DATA 

0018 

pool 1 

DOFF 


RAO- 

I 


nni 9 

pool 2 

moo 


1 DA 

=N-1 0, T 

1 n FT? AMF S 


P0013 

FFF5 





nn?n 

pnm 4 

0101 


8A7 

1 


0021 

P0015 

18F9 


JMP<^ 

WRITE 


nn ?2 

pool 6 

8839 


RT.Jl^ 

1 FADFR 

00 OUTPUT TRAILER 

0023 

P0017 

0000 

STOP 

SLS 

0 


0024 

POO 1 8 

0 D 0 1 


INQ 

1 

PPFPARF FOR FTTNOTTON 

0 025 
0026 

P0019 
pool A 

OAoi 

0 3FF 


ENA 

OUT 

i 

-1 

CLEAR CONTROLLER 

0027 

POOIB 

02FE 


INP 

-1 

INPUT STATUS 

002R 

pno 1 n 

OFCF 


Al S 

15 

ready PTT 

0029 

POOID 

0131 


SAM 

1 

"skip when ready 

0030 

pool F 

1 8FF 


.IMP* 

*-3 

GH WATT ITNTTT, READY 

0031 

POOIF 

COOO 

SEL 

LDA 

=N$2000 

TTS MODE 


P0020 

20 0 0 





0032 

P0021 

OBOO 


NOP 



0033 

P0022 

03FE 


OUT 

-1 


0034 

P0023 

0A20 

MOTION 

ENA 

$20 

START MOTION 

0035 

P0024 

0 3KE 


OUT 

-1 


0036 

POO 25 

ODFE 


INQ 

-1 

PREPARE FOR DATA 

0037 

P0026 

OBOO 


NOP 



0038 

0039 

P0027 

P0028 

0 2FE 
0118 

LDR 

INP 

SAN 

-1 

STORF-*-l 

INPUT DATA 

STORE WHEN DATA COMES 

0040 

P0029 

ODOl 


INQ 

1 


0041 

P002A 

18F4 


JMP* 

SEL 

GO WAIT for data 

0042 

P002H 

COOO 

READ 

LDA 

=N$2000 

TTS MODE 


P002C 

2000 





0043 

P002D 

0001 


INQ 

1 

FUNCTION 

0044 

P002F 

OBOO 


NOP 



0045 

P002F 

03FE 


OUT 

-1 


0046 

P0030 

0A20 


ENA 

$20 

START TAPE MOTION 

0047 

P0031 

03FE 


OUT 

-1 


0048 

P0032 

ODFE 


TNQ 

-1 

DATA 

0049 

P0033 

0 2FE 


INP 

-1 

INPUT DATA 




Kililsn 

STM ^ 


M lulu 
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0052 PU036 ClOO 


20 FRAMES 


0053 P0038 0101 


0055 P003A OOOO KINI 

0056- P003B . 0-0 1-4 fePJF 

0057 P004F 0000 LEADER 


FINI-*-l 


STOP AFTER READING 

SWEEP BUFFER TO CHECK 

WRITE LEADER OR TRAILER 


P0051 7HCD 


0060 P0053 0844 


0062 P0055 DOFF 


RAO- 


0064 P0057 18FC 


JMP* 


OUTLDR 


0066 P0059 1CF5 




12.5 


12.5 1726/405 CARD READER 

The 405 is a Non- Buffered Card Reader capable of reading 1200 80-column cards per 
minute or 1600 51-column cards per minute. The transfer rate for one 80-column card 
is 384 microseconds. 


The twelve rows in each column constitute the 12-bit data word transferred to the com- 
puter. Software packing must be performed in order to form a 16-bit word. The format 
for the columns in relation to memory words is as follows : 



15 


7 4 

3 0 

Word 1 

Col 1 (12 rows) 

Col 2 (4 rows) 

Word 2 

Col 2 (8 rows) 

Col 3 (8 rows) 

Word 3 

Col 3 (4 rows) 

Col 4 (12 rows) 


Four card columns represent three computer words, therefore, one 80-column card 
represents 60 memory words. 

The data read by the 405 may be buffered if connected to the 1706. 

The Q Register will be in the following format when referencing the 405 Card Reader. 


Q 


15 11 10 7 6 


1 0 


W = 0 


E 


D 


The E portion will correspond with the setting of the equipment switch on the controller. 
The D portion designates the operation to be performed. 

12. 5. 1 CR Functions 

D = 1 DIRECTOR FUNCTION (OUT) 


LDQ 

=N$0101 

EQUIP 2, FUNC 

EDA 

=NFUNC 

FUNCTION IN A 

NOP 



OUT 

-1 

ESTABLISH LOGIC 

13 12 

11 10 9 8 7 6 

5 4 3 2 1 0 


A 













4 i 

Reload Memory 

1 

1 

k A i 

Gate Card 
SFegate Hollerith to 
ASCII 

i i 

k i 

r 

k 4 ^ 

J CLR Controller 
CLR INT 
)ata INT 


Release Negate Hollerith 
to ASCII 


EOF INT 
Alarm INT 
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The functions for the 405 Card Reader may be issued jointly. 

Clear Controller (Bit 0); Directs the clearing of all interrupt requests, motion 
requests, errors, and other logic that may be cleared. This function is sub- 
ordinate to all other functions. 

Clear Interrupts (Bit 1): Clears all interrupt requests and their responses. 

Data Interrupt Request (Bit 2): Sets the interrupt request to be set which causes 
an interrupt to be generated when an information transfer may occur. 

Interrupt on End of O peration (Bit 3): Requests an interrupt to be generated when 
the last card column has been read or a Reload Memory Function has been per- 
formed. 

Interrupt on Alarm (Bit 4) ; Generates an interrupt whenever any of the following 
conditions arise: 

1. Compare or pre-read error 

2. Stacker full or jam 

3. Input tray empty 

4. Fail to feed 

5. Separator card is read into computer memory 

6. Auto/man switch is in man position 

Gate Card (Bit 9); This bit gates the card being read to the secondary stacker. 
This function must be performed during the 1. 5 milliseconds following the input 
of the last column to the buffer memory of the Card Reader. 

Negate Hollerith to ASCII (Bit 10): Whenbit AlO is selected, 7 and 9 punch positions 
in column 1 are ignored and all information (binary or Hollerith) is read as binary. 
Bit AlO is subordinate to bit All. Bit AlO is rejected if the controller is Busy. 

NOTE 

Before beginning a new operation, make certain that bit AlO and the 
following bit, All, are appropriately selected. If this is not done, 
the cards will be read in the mode or state that the card reader was 
in during the previous operation. 

Release Negate Hollerith to ASCII (All = 1): When bit All is selected, the 7 and 9 
punch positions in column 1 determine whether the card information is to be trans- 
ferred in ASCII code or in binary form. The Release Negate Hollerith to ASCII 
function takes precedence over the select Negate Hollerith to ASCII function, and 
it is rejected if the controller is Busy. See Note. 
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Reload Memory (A12 = 1) : This bit directs the controller to initiate a card feed 
thereby reloading the controller memory with the data from the next card in the 
card reader. The data that has not been transmitted from the memory to the 
computer is lost when Reload Memory is executed. A Reload Memory is required 
only if less than a full card of information is desired. Bit A12 is rejected if the 
controller is Busy. 


12.5.2 CR Status 

D = 1 STATUS (INP) 


LDQ 

NOP 

=N$0101 

EQUIP 2, STATUS 

INP 

-1 

STATUS IN A 


15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 




A i 

1 i 

ft t i 

k i 

i 4 

t ♦ 



1 Alarm 



1 Ready 



Protected 



Busy 


Error 


Interrupt 

1 Binary Card 

Data 

Separator Card 

EOP 



I Fail to Feed 
Stacker Full of Jam 
Input Tray Empty 
End of File 

Manual Switch or Motor Power Off 


Ready (Bit 0) : The presence of this bit indicates that the card reader is ready for 
operation. 

Busy (Bit 1): The controller is Busy whenever a card is being entered into the 
buffer memory. 

Interrupt (Bit 2) ; The interrupt status is available if one or more of the selected 
interrupts has occurred. Other bits must be monitored to determine the condition 
causing the interrupt. 

Data (Bit 3): This status bit indicates that data is ready to be transferred to the 

computer. 
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End of Operation (Bit 4) ; This status bit indicates that the last card column has 
been read from the buffer memory, or a reload memory function has been sent. 
This bit remains al until a Reply signal is sent, or a Clear Controller function or 
Master Clear is issued. 

Alarm (Bit 5) ; The bit remains a 1 until whatever caused the Alarm condition is 
removed. This status bit indicates that one or more of the following conditions 
has occurred: 

1. Compare or Pre-read error 

2. Stacker full or jam 

3. Input tray empty 

4. Fail to feed 

5. A separator card has been transferred to the computer memory. 

6. The AUTO/MAN switch is in the MAN position 

Status bit A06 is not used. 

Protected (Bit 7) : This status bit indicates that the controller recognizes only the 
l/ O instructions that have the protect bit present. This status bit is a 1 when the 
protected/unprotected switch is in the PROTECTED position. 

Error (Bit 8): This bit indicates that a Pre-read or Compare error has occurred. 

Binary Card (Bit 9)t This bit is present when the contents of the first card column 
have been transferred to the computer memory and a binary card (rows 7 and 9 
punched in first column) was detected, or the Negate Hollerith to ASCII function 
was selected. This bit remains a 1 until a Clear Controller or Master Clear 
function is issued, or a Reply is sent when a card is read under the following 
conditions : 

1. The card is not a binary or a separator card. 

2. The Release Negate Hollerith to ASCII function is selected. 

Separator Card (Bit 10): This bit is present when the contents of the first card 
column have been transferred to computer memory and a separator card (rows 6 , 
7, 8, and 9 punched in first column) was detected. This bit remains a 1 until a 
Reply is sent when a card is read that is not a separator card, or until a Master 
Clear or Clear Controller function is executed. 

Fail to Feed (Bit 11): This bit is a 1 if another card is not detected at the primary 
read station 500 ms after the previous card has cleared the secondary read station. 

Stacker Full or Jam (Bit 12) : This bit is a 1 when the stacker is full of cards or 
when the cards have jammed. 

Input Tray Empty (Bit 13): This bit is a 1 when the input tray is empty. 
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End of File (Bit 14): This status bit becomes a 1 when the input tray is empty, the 
buffer memory is unloaded, and the END OF FILE switch is on. When the input 
tray does not contain the last card of a file, the switch should be off to inhibit this 
status bit. 

Manual (Bit 15); This status bit is a 1 when the AUTO/MAN switch is in the MAN 
position or the MOTOR POWER switch is off. 

D = 0 DATA (INP) 

LDQ =N$0100 EQUIP 2, DATA 

NOP 

INP -1 DATA IN A REG 


A 


15 12 11 


0 


0 0 0 0 


DATA 


Packing must be performed in order to obtain 16 bit words as indicated earlier in 
this discussion. 
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12. 5. 3 CR Example Program 



NAM 

CARDRD 


EQU 

AA($3FF), CARD($0281) 


EQU 

MASKB($000F) 


BSS 

TEMP(2) 

START 

CLR 

A 


STA- 

I 

SECOND 

LDQ 

=XCARD 


LDA 

NOP 

=N$1A03 


OUT 

-1 


INQ 

NOP 

-1 

LOOP 

INP 

-1 


ALS 

4 


STA* 

TEMP 


INP 

-1 


STA* 

TEMP+1 


ARS 

8 


AND 

=XMASKB 


ADD* 

TEMP 


STA* 

AA.I 


LDA* 

TEMP+1 


ALS 

8 


AND 

=N$FF00 


STA* 

TEMP 


INP 

-1 


STA* 

TEMP+1 


ARS 

4 


AND 

=X$00FF 


ADD* 

TEMP 


STA+ 

AA+1,I 


LDA* 

TEMP+1 


AND 

=X MASKB 


ALS 

12 


STA* 

TEMP 


INP 

-1 


AND 

=N$0FFF 


ADD* 

TEMP 


STA* 

AA+2,I 


LDA- 

I 


INA 

3 


STA- 

I 


INA 

-54 


SAZ 

1 


JMP* 

LOOP 


LDQ 

=XCARD 


RAO 

*+3 


LDA 

=N$7FFA 


SOV 

1 


JMP 

SECOND 

DONE 

SLS 

END 


03FF 

CARD 

0281 

0004P 

LOOP 

OOOCP 


SEL EQUIP 5 F 


CLR CON CLR INT RM H TO A 

OUTPUT FUNCTION 
PREPARE FOR DATA INPUT 

INPUT TO A FIRST COLUMN (12) 
DATA UPPER 1 1 BITS . . . ZERO 

INPUT 2nd COLUMN 
SAVE THE DATA 
UPPER 4 BITS IN LOWER 4 
ZERO UPPER 12 BITS 
FIRST WORD PACKED 


LOWER 8 BITS IN UPPER 8 BITS 
ZERO LOWER 8 BITS 

INPUT 3rd COLUMN 

UPPER INPUT 8 BITS IN LOW 8BITS 
ZERO UPPER 8 BITS 
PACK 2nd WORD 
PLACE IN BUFFER 

ZERO UPPER 12 BITS 
LOWER 4 BITS IN UPPER 4 BITS 


THIRD WORD PACKED 

GET INDEX 
UPDATE INDEX 


IF END OF CARD SKIP 
CONTINUE 


MASKB OOOF TEMP OOOOP 
DONE 003EP 
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12.6 1742 LINE PRINTER 

The 1742 Line Printer (the Holley HR-300 Printer) prints 300 lines per minute, each 
line being 136 characters. The printer accepts ASCII codes with two characters per 16 
bit word. The printer has a holding register capable of accepting an entire line before 
printing: 136 characters (8 bits) or 68 words (16 bits). The ASCII codes require 7 bits, 
therefore, the 8th bit is used as a print control bit. This bit on each character is set 
by the controller when the character is received. As the printer actually prints the 
character, the 8th bit is cleared. When all print control bits have been zeroed, the 
printer has completed the print operation and is ready to receive data from the computer. 
The programmer is not required to send the maximum number of characters to the 
printer. The printer accepts the characters sent by the program and blanks the re- 
maining positions prior to printing. 

The Q Register will address the printer in the following format: 


15 11 

10 7 

6 

1 0 

W 

E 


D 


The W portion will equal zero. The equipment number will correspond to the equipment 
setting of the hardware switch on the controller ($0-$F). The D portion will direct the 
type of transmissions to and from the A Register. 

DATA 


D=00 indicates the transfer of data to the printer's holding register. It will always be 
issued with an OUT instruction. 


LDQ 

=N$0380 

EQUIP 7, DATA 

LDA 

DATA 

PLACE DATA IN A 

NOP 

OUT 

-1 

DATA SENT TO PRINTER 


12.6.1 LP Functions 

DIRECTOR FUNCTION 1 

D=01 denotes the transfer of Director Function 1, which allows the programmer 
to CLEAR PRINTER and CLEAR INTERRUPTS. It also provides the medium for 
selecting as many as three interrupts: DATA, EOP, and ALARM. 


A 


15 

5 

4 

3 

2 

1 

0 

0 0 0 0 0 0 0 

0 0 0 0 

1 1 

1 ^ 

1 

1 ^ 

1 ^ 1 


t ^ t t 

EOP I 


Alarm 




Clear Controller 
Clear Interrupts 
Data Interrupt 
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12 . 6.1 


LDQ 

=N$0381 

EQUIP 7, FUNC 1 

LDA 

FUNCl 

PLACE FUNC IN A 

OUT 

-1 

SEND FUNC 


DIRECTOR FUNCTION 2 

D=ll accompanied by an OUT instruction sends Director Function 2 to the printer 
from the A Register. 


LDQ 

=N$0383 

EQUIP, FUNC 2 

LDA 

FUNC2 

PRE SET A TO FUNC 

NOP 



OUT 

-1 

SEND FUNC FROM A 

13 12 

11 10 9 8 7 

6 5 4 3 2 1 0 


I Print 
Single Space 
Double Space 
Level 1 


t t ^ ^ r 4 t ^ t f 4 

12 11 10 9 8 7 6 5 4 3 2 

8- Line Select 


Print (Bit 0=1) — ►Commands the printer operation to begin. Once the entire 
line has been printed the operation is complete. The print 
command must be issued for each line printed. 

Single Space 

(Bit 1 = 1) ► Advances the page by one line. 

Double Space 

(Bit 2 = 1) ► Advances the page by two lines. 

Format Level 

(Bit 3 - Bit 14) — ► This command causes paper motion. The paper is moved to 
the next hole punched in the specified level. The tape levels 
are used for formatting documents, as the levels may be used 
instead of the spacing commands. Level 1 usually specifies 
top of page while level 12 usually specifies bottom of page. 

8- Line Select 

(Bit 15 = 1) ► This bit changes the logic to allow for 8 lines per inch rather 

than 6 lines per inch. Once 8 lines per inch has been selected 
it remains in effect until a MASTER CLEAR, CLEAR CON- 
TROLLER, or bit 15 is issued as a zero. 
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12 . 6.2 


12.6.2 LP Status 

D=01 with an INP instruction requests status. 


LDQ 

NOP 

=N$0381 

EQUIP #7, STATUS 

INP 

-1 

BRING STATUS TO A 




The status of the Line Printer notifies the program of the READY and BUSY states 
of the printer by setting bits 0 and 1, respectively. Bit 2 indicates the existence 
of an interrupt, while bits 3, 4, and 5, designate which interrupt was generated. 
Bit 3 is the bit indication that the printer is prepared to receive data from the 
computer. Bit 4 notifies the program that an operation is complete, such as a 
print or top of form command. Bit 5 indicates an ALARM condition has occurred, 
such as out of paper, paper tear, fuse alarm, open interlock, or an illegal char- 
acter. Bit 7 corresponds with the Protect Switch on the printer. If the switch is 
on, bit 7 will be set and only protected programs will be allowed to use the printer. 
Bit 9, when set, acknowledges that a change from 6 to 8 lines per inch may be 
effectively made. 

12. 6. 3 Programming the Printer 

Programming the printer simply requires advancing the page to the desired print 
level. Once the page is positioned, data is sent to the printers holding register. 
Once the data has been sent to the printer, the print command is issued. When 
the printer completes the print cycle, the program advances the page by level 
selection, or spacing and outputs the next line. The programmer selects the top 
of page level (usually Level 1) once a page is complete. 


O 
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12.6.4 


12.6.4 Example, 1742 Line Printer 


0001 mam print 

-OWP — -^T 09-P4T - - - 

oon? >0000 p;ooo ppimt lom =M<^07«i EQUIP .15, FUNC 1 

.>00 01 oyqi 

OTMIA- H000-2-0AO1 - _ .FiiA - - --I CLR CONTROLLER 

0005 POOO? 03FF . OUT -1 

0006 P0004 FOOO LOQ =i\jS0733 EQUIP 15, FUNC 2 

POOO^ — - 

00 07 POO 06 OAOq FMA 4 LEVEL 1 TOP OF FORM 

0008 P0007 07FF OUT -1 

-G-O-OR -F'OO-O^-GOOi) - LOA ^X-ftTEFF-S LOOP FOR OVERFLOW - 

POOOQ 7FFA 

0010 POOOA 68?6 STA^^ LIMFCT 6 LINES PER PAGE 


001 ? 

0013 

-6014- 

0015 

0016 
-&TH-7- 


ROOOC 

ROOOn 

-R060F- 

POOOF 

POOlO 

-PTHH-T- 


60FF 

OOFC 

-GR-14 

OROO 

03FE 

COFF - 




-mj-T- 


0018 

OOIR 

60?0- 


POOIP 
R0013 
-R 60-1-4 


ORFF 

<^10? 

»OF-F- 


STA- 
I MO 

LOA^- 

NOP 

OUT 

— 

IMA 

SAZ 

--R-AO-- 


T 

-3 

__ £)A-T-A, I 

-1 

— F 

-511 

NEXTL 


ZERO INDEX . 

PRINTER FOR DATA 
2 ASCII CHARACTERS- 


GHECK WORD LOOP 


00?1 P0015 
00?? P0016 

18F8 

O.D03 

n /\ 0 ] 

JMP-K- 

MEXTL I MO 

... F-NA 

OUT 

3 

4 

00?4 P001« 

03FF 

OUT 

-1 

00?5 Pool 9 

0 A04 

ENA 

4 

66-?^ -4061 4- 

.n-iFF.- 

OUT - -- 

- - -1 — 

00?7 -POOIR 

0815 

RAO* 

LiNf 

00?8 POOIC 

01 A1 

SOV 

CMP 

on?q POO in 

-6850- 

-- JMO* - 

CMT- 


17 CHARACTER PER LINE 
SKIP IF COMPLETE 
NOT G(MP - UPDATE INDEX- 
CONTINUE LINE OUTPUT 
LINE COMPLETE, FUNCTION 
PRINT-e»1AND — 


0 030 
0031 


POO IP 

POO IF 


0000 

•5448 


CMP 
OAT A 


SLS 

AI.F 


DOUBLE SPACE 

UPDATE LINE COUNT 
SKIP IF PAGE COMPLETE 
-CONTINUE IF PAGE- 


<STHIS PROGRAfF ,,/opks ON PRINTER 174?^^ 


-p-e6?6 -495-3 ^ — — 

P00?l ?050 
POO?? 5?4F 

P OO?3 -47^ ^ 

:>nr,iPA. 4140 
P00?5 ?057 

P4G-?6^-4FF^? 

P00?7 4R53 
P00?8 ?04F 

an t 3? a--4-F^ 

POO? A 50=^? 

'-0 0?« 4Q4F 

--R-OtO-PC-— 5445 - - — - 

Poo?n 5??o 
P00?F 3137 

— ^ - 343? 

003? ^0030 nool RSS LlM^CTd) 

0033 EMU PRINT 
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THIS PROGRAM WORKS ON PRINTER 1742 


— T-HTS- 


-WORKS- 

-m- 

poiMTrp 

-4-7^2— 

THIS 

PROGRAM 

WORKS 

OM 

PRINTER 

1742 

THIS 

PROGRAM 

WORKS 

ON 

PRINTER 

1742 


p p n r: A 

r“ T . 1 T ■ j ^ M 

->40Ok:q- 

-ON- 

-PRINTER- 

■ 1742 -■ 


THIS PROGRAV1 i.JOPKS ON PRINTER 1742 


Note what happens in the following program when the functions for print command 
and double space are issued simultaneously! (Line 23, ENA 5.) 
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Pf^INT 



34 




12.6.4 


o 



_^MTc; PP0<^9AM OPK 5 OM PRIM^^P 174? 
^HT<; PPQGPAM '"^ORKg ON PRIMMER 174? 

_^MTc^ pPQr;q>/^M ’ORKs OM dRIN'^EP 174? 

HI P OG AM '"^0 K 0^) P IN E. 174? 


Digigraphics - September 1969 
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12.7 1738/853 DISK 

The disk is a buffered peripheral device attached to the 1705 Direct Access Bus. All 
data will be buffered in and out of memory via the 1705 in 16-bit words. The functions 
will be sent from the A Register and status will be received in the A Register, nec- 
essitating the connection to the A/Q channel. The disk transfers 16-bit data words in 
12. 8 microseconds. Access time for positioning the head is 165 milliseconds maximum. 
Cylinder- to- cylinder pos itioning time is 30 milliseconds. The disk has a maximum 
latency time of 25 milliseconds. 

Ninety-six 16-bit words may be stored on one sector with 1,536 words on a track and 
15, 360 words to a cylinder. The 853 disk pack allows a total of 1, 536, 000 words, while 
the 854 disk pack has a capacity of 3, 118,080 words. 

The data format may be summarized in the following: 

16 Bit data words 
96 Words to a sector 
16 Sectors to a track 
10 Tracks to a cylinder 
100 Cylinders to an 853 file 
203 Cylinders to an 854 file 

The three interfaces for communications with the 1738 controller are the A/Q channel, 
DAC (1705) and the CONTROLLER/FILE. The A/Q channel is the interface between 
the controller and the programmer. It is via the A/Q channel that the programmer 
may status the disk and issue functions. The DAC is the interface between the controller 
and the computer's memory. It is via this channel that the data is transferred. The 
DAC also provides the 1738 access to the LWA+1 of the programmer’s buffer area. 
controller/file interface is used for communications between the controller 
and the disk. It is through this interface that the controller informs the disk of the 
Sector Record Address selected by the programmer. The SEEK operation which posi- 
tions the read/write heads to the SECTOR RECORD ADDRESS is generated by the 
controller once the controller receives the desired address from the A/Q interface. 
The controller will issue a SEEK FORWARD or SEEK REVERSE command depending 
upon the current position of the read/write heads. It does not return to a set address 
prior to positioning on a new address. 
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SIDE VIEW: 

850 DISK PACK 
(6 DISKS) 
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- DISK SURFACE 0 

- DISK SURFACE 1 


DISK SURFACE 9 


TOP VIEW: 
DISK SURFACE 



CYLINDER 00 — 


CYLINDER 99 — ' 



ROTATION 


SECTOR 14 
SECTOR 15 
SECTOR 0 
SECTOR 1 


853 contains 100 cylinders; 854 contains 203 cylinders. 


Figure 29. Disk 


o 
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12.7 


Figure 30. Sector Format on Disk 


ADDRESS DATA 



Each sector on the disk contains the above information. Note that the 96 16-bit words 
of data (1536 data bits) are in addition to the other check bits in the sector. 
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12.7 


The Q Register will contain the address of the disk. 



15 




11 

10 


7 

6 

5 

4 

3 

2 0 

Q 1 





^0/ 

E 





D 


W Equipment Director Bits 

W field is zero and E field contains equipment number (set on controller). 

The setting of the director bits will define the desired operation to the controller. 
The contents of the A Register will vary according to the director bits. 


12. 7. 1 Disk Functions 


DISK FUNCTION CODES 


Value Set in Q 
(Bits 02 - 00) 

Output from A 

Input to A 

001 

Director Function 

Director Status 

010 

Load Address 

Address Register Status 

Oil 

Write 


100 

Read 


101 

Compare 


110 

Checkword Check 


111 

Write Address 



12.7. 1. 1 Director Bits 001 - Director Functions 

This setting with an OUT instruction prepares the controller for director functions 
which are found in the A Register. The functions for the disk may all be sent at 
the same time. 


15 


Unit Select Code 
Unit Select — 
Release - 


10 9 8 7 6 5 4 


I t 

I Clear Interrupt 
Ready & Not Busy Interrupt 
End of Operation Interrupt 
Alarm Interrupt 


The CLEAR INTERRUPT function will clear all selected interrupts allowing the 
programmer to select the interrupts he desires. Three interrupts may be 
selected: NEXT READY AND NOT BUSY STATUS, END OF OPERATION, and 
ALARM. The NEXT READY AND NOT BUSY interrupt occurs when the 1738 
becomes not busy, but still maintains its ready status. This interrupt can be used 
during an overlap seek. The overlap seek is used when two disks are connected 
to one controller. The programmer may issue a sector record address for one 
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12.7.1.1 



disk and then issue a sector record address for the other. The controller will 
generate a NEXT READY AND NOT BUSY interrupt, if selected by the programmer, 
when one of the disks reaches the requested address. 

The END OF OPERATION interrupt allows the controller to inform the 1700 when 
it has completed an operation such as a data transfer. The ALARM INTERRUPT 
will notify the 1700 that an alarm condition has arisen. There are eight possible 
alarm conditions; not ready, checkword error, lost data, seek error, address 
error, defective track, storage parity error, and protect fault. 

The RELEASE function allows an unprotected program to use the disk even though 
the protect switch on the disk is still set. A protected program must issue the 
release function. The next time a protected program accesses the disk, the disk 
will become protected and must again be released before the disk will become 
accessible to an unprotected program. 

The UNIT SELECT and UNIT SELECT CODE will always be zero unless two disks 
are connected to the 1738. Bit 8 is the UNIT SELECT bit which informs the con- 
troller that the program will select unit 0 or unit 1. Bit 9 indicates which unit 
bit 8 wishes to select. If bit 9 is a 0, unit 0 is selected; if it is a 1, unit 1 is 
selected. The controller ignores bit 9 unless bit 8 is set. 

12.7.1.2 Director Bits 010 - Sector Record Address 

This director code in the Q Register with an OUT instruction will send the SECTOR 
RECORD ADDRESS from the A Register to the controller. Once the controller 
receives the address, it initiates the seek operation. The SECTOR RECORD 
ADDRESS will be in the following format: 

15 8 7 4 3 0 

A 

12. 7. 1. 3 Director Bits 011 - WRITE 

The WRITE function code requests the controller to prepare to read data from 
memory and write it on the disk. Prior to this function, the programmer must 
send the SECTOR RECORD ADDRESS to the controller. 

The controller expects to find the first word address minus 1 (FWA-1) of the buf- 
fer area in the A Register when the write function is received. The controller 
goes into memory via the DAC to the FWA-1 at which location he extracts the last 
word address plus 1 (LWA+1). The controller keeps the LWA+1 and updates the 
FWA-1 until the two are equal at which point the write operation is complete. 

Prior to issuing the WRITE function, the SECTOR RECORD ADDRESS must be 
sent to the controller and the LWA+1 of the buffer area must be at the FWA-1. 
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12.7.1.4 


12.7.1.4 Director Bits 100 - READ 

The READ function code follows the same programming procedure as the WRITE 
function. The difference being the disk reads data into memory rather than 
writing data on the disk. An unprotected program may READ from a protected 
disk without generating a protect FAULT, however, if an unprotected program 
attempts to write on a protected disk, a protect fault will occur. An alarm in- 
terrupt will be generated if previously selected. 

12. 7. 1. 5 Director Bits 101 - COMPARE 

The COMPARE function code follows the same programming procedure as the 
READ and WRITE function codes. The COMPARE function causes the controller 
to read data from the computer’s memory and compare it with the data stored on 
the disk. If at any time during the compare, one word does not compare, the NO 
COMPARE status bit will be set. This function provides an extra check on the 
validity of the data transferred. 


12. 7. 1. 6 Other Director Functions 

The remaining director functions (CHECKWORD CHECK and WRITE ADDRESS) 
are used by the customer engineers for maintenance work. 

12.7.2 Disk Status 


12. 7. 2. 1 Director Status 


D = 001 accompanied by INP instruction, will request the 1738 to send status to 
the A Register. 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 


4 4 

Protect Fault 
Storage Parity Error 

Defective Track 
Address Error 

Seek Error 

Lost Data 
Checkword Error 


♦ ♦ ♦ * i I I 

I Ready 
Busy 
Interrupt 
On Cylinder 
End of Operation 
Alarm 
No Compare 
Protected 
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12.7.2.1 


The READY status indicates that the unit is available. The BUSY bit indicates 
that the controller and/or the drive unit is presently involved in the performance 
of an operation. This bit is set with the acceptance of a LOAD ADDRESS, WRITE, 
READ, COMPARE, CHECKWORD CHECK, or WRITE ADDRESS function. At the 
completion of the function which set the BUSY status, the status will be cleared 
and the disk will become NOT BUSY. Once the disk is NOT BUSY, a new function 
may be issued. 

The INTERRUPT bit acknowledges that an interrupt has occurred. Further ex- 
amination of A will determine which of the three selected interrupts was generated; 
bit 4 (EOP) and bit 5 (ALARM). If neither bit 4 nor bit 5 is set, the programmer 
should check bits 0 and 1 for READY and NOT BUSY. If the alarm bit is set, the 
programmer must evaluate A further to determine which of the eight alarm con- 
ditions caused the interrupt. 

The ON CYLINDER status, bits, is set when the READ/WRITE heads have 
reached the SECTOR RECORD ADDRESS initially sent to the controller via the 
A/Q channel. 

12.7.2.2 Address Register Status 

The D=010 Q setting accompanied by an INP instruction will direct the controller 
to return the current sector record address of the disk to the A Register, the 
location at which the READ/WRITE heads are currently positioned. It will be in 
the same format as described in the Address Function. 
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12. 7. 3 Disk Sample Programs 


.0001 

- ^ 0 ? 

0003 POOOO COOO DISK 


NAM DISK 

WF 

LOA =XL«'PO LWA+1 IN ’A» 


POOOl OOP? 

— 00 ~ 0 4 — PfHHF? — S"TA — LWA+1 AT FWA”1 

P0003 on?E 

0005 P0004 D800 RAO FLAG UPDATE FLAG FOR LOOP 

POWf-AOiHb - - - 

0006 P0006 EOOO LDO =N50101 EQUIP 3, FUNCTION 

P0007 OlRl 

— 0 0 07 — POO OP — 0 A 0? ENA — $O00? CLR INT -- 

0008 P0009 03FE OUT -1 

0009 POOOA EOOO ZAP LOQ =N$018? EQUIPS, LOAD ADDRESS 

POOOP-O+OP ^ - - 

0010 POOOC OAin ENA <K0010 CYL 0, HEAD 1, SECTOR 0 

0011 POOOn 03FE OUT -1 

-OO+e-POOF) E-E-0 00 b!Kl — =NSO 1-8+- EQUI P 3 , STA.TUS 

POOOF 0181 

0013 POOlO OBOO NOP 

- 0014 - POOH 0?FE 5+AT TNP + STATUS IN A 

0015 POOl? OFCC ALS 1? ON CYL 

0016 P0013 0131 SAM 1 SKIP WHEN ON CYL 

--O01 7-POO1A--18F-0- UHP^ - STAT - WAIT 

0018 P0015 ICOO MUM SICOO JMP (0) 

0019 P0016 0000 FLAG 0 0 

-O 0 -P O --P 00 - 17 - 0 - 0 1 9 -0 AN€- -> .^R I - T € GO^ WRITE - - 

00?1 poors 00?A P AOC READ GO READ 

00?? POOIP COOO WRITE LDA =XFWMq FWA-1 IN A 

POOIA 0031 P - - 

00?3 POOIR EOOO LOQ =N$0183 EQUIP 3, WRITE 

POOIC 0183 

-^t> 4 --Pf> O-l-D—OB 0 0 NGP ^ - 

00?5 POOIE 03FE OUT -1 

00?6 POO IF EOOO XX LDQ =N$0181 EQUIP 3, STATUS 

PO-030 0181 — : - - 

' 00?7 P00?1 .OBOO , NOP 

00?8 POO?? 0?FE LOOP INP -1 STATUS IN 'A' 

-^?9 -P 0 0^ 3— 0 F C 9 ALrS^ — 11-- CH FOR END OF OP 

0030 P00?4 0131 SAM 1 SKIP WHEN COMP 

.0031 P00?5 18FC JMPi^ LOOP WAIT 

-&A-3e->^00?6-0000 5bS — 0 — STOP TO ZEROl BUF FROM CONSOLE 

0033 P00?7 0800 RAO FLAG ADD 1 FLAG READ 

P00?8 FFED . 

4o 3 4 - P 00? 9 - 18F0 J MP< * - ?AP -CGNTINUE , - READ - - - 

0035 P00?A COOO READ LDA =XFWMO FWA-1 IN A 


P00?.R 0031 ° 

- 0 0 3 6- ?C— E8-0I> bON— =fWHr84 -EQUIP- 3 , READ 

P00?D 0184 

0037 P00?F 0000 NOP 

^0038 P00?r 03 FE -DOT + 

0039 P0030 18EE JMP<^ XX GO STATUS FOR END OF OP 

0040 P0031 0001 87S FWMO(l) 

^ 04i - PQ03? 00 6 0 — GTS — FW A( 96) - 

0042 >009? 0001 8ZS LWPO(l) 

;J0043 : END DISK 
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; 0001,,'- ' ' _ , NAM disk 

OOOg -P OOOO FOflO er T -AP- T LDQ gN^Oiai • EQUIP 3, F UNCTION 

POOOl 0181 

'0003 POOO? 0844 CLR A INITIALIZE INDEX 

00Q4 -POO 03. 60EE . ST A- L- — — — 

0005 POOOA ,c6bo LDA =N$0002 CLEAR INTERRUPTS 

^ P0005 -0002 . . 

10006 - ^OOOA OROO'^ ^' ^ — NDP ' ' ' " " 

i 0007 P0007 03FE DUT -1 

10008 P0008 EOOO LDQ =N$0182 SECTOR RECORD ADDRESS 

; P 0009 0182 — r— > 

! 0009 POObA COOOCf-Vl-^^V LDA ^ =NS460 CYL4,HEAD6, SECTOR 0 

[ ; P0008 0460' ’ 

■ 0010 POOOC OBOO '' - ' HBP ^ ^ 

I 0011 POOOD 03FE OUT -1 

10012 POOOE EOOO LDQ =N$0181 EQUIP 3, STATUS 

' " ■ ; ^ ^ 


0013 

0014 
fvm 

POOlO 

poon 

n n A i "i 

OBOO 

02FE 

ncA -5 

TEST! 

NOP 

IMP 

ADC 

-1 

STATUS IN A 

ru'pny PVT 

V U 

0016 
n n 1 -7 

T'U U 1 

P0013 

P0014 

A ft 1 c 

AOOO 

0001 
ft 1 1 1 


I 1 ^ 

AND 

CAM 

= XMSK 

l./R T TC 

— tFttiroix — cttI — trrlj 

STTTP TF ON rVT 

U U 1 f 
.0018 
0019 


U Jt X JL 

18FA 

COOO 

- WRITE 

/: ^ ^ ' V •• 

JMP<^ 

LDA 

TESTl 

=X8UF+96 

■ “itf t/ri Kj 1 Li — 

WAIT UNIT ON CYL 
LWA+1 


^001 - 8— OOP - 7- F^- 


|0020 P0019 6800 5TA BUF-1 STORE AT FWA-1 

POOIA 003C 

;0021 POOIB CQOO ^ — — LDA =X B UF - 1 LOAD— LA^PWA*1“ 

fV POOIC 0056 P 

0022 POOlD EOOO LDQ =N$0183 EQUIP 3, WRITE 

^ ■ : : , , , ^ 

0023 POOIF OBOO NOP 

0024 P0020 03FE OUT -1 

^ - O e5 - P 0021 EOOO — — bDO =N$0I81 EQUIP-:-3-r-STATU& 

. P0022 0181 

0026 P0023 0800 TEST2 NOP 


-0027 

0028 

0029 

P0034 

P0025 

P0026 

.riA Arj-7 

02FE ^ 

0F44 

AOOO 

AAAI 

- INP 

ARS 

AND 



4 

= XMSK 

- STATUS IN A — 

CK END OF OP 

^030 

0031. 

A .K '-ri ■ 

^ U U C T 

P0028 
POO 29 

rtft ftft « 

• V V y X- Ai . % V 1 '\N ' V 

0111. , 

18F9, 

A A A y. ^r^r\r\ ' 

. SAN 
JMP« 

Pt n 

^ ZERO 
TEST2 

A 

SKIP WHEN COMPLETE 
CONTINUE WAITING * / 

r u u J i- 
0033 

A A 

^17 i/z:: A 

P002R 

P002C 

rift mr\ 

IPjHH "/.LKU 

6900 

0028 

nnrp 

UUi\ 

STA 

DAD 

A 

BUF»I 

T 

ZERO BUFFER AREA 

TTPHATP T 

V t# w ^ 

0035 

"0036- 

Pt/UcU 

P002E 

P002F 

-poaeo 

iX U f • »V -.y -V 

coob, 

0060-' 

■■9 OFF'''- ' 

LDA 

---SUB- 

=XCOUNT 

— — 

— Url/rilCi; x 


|0037 P0031 0132 SAM READ IF COM SKIP 

|0038 P0032 1800 JMP ZERO CONTINUE ZERO UNTIL COMPLETE 

I P 003 - 3 - F FF6 : ; .. - r : ^ 

>0039 P0034 0000 READ SLS STOP TO CK BUFFER 

!0040' P0035 EOOO LDQ =N$0182 EQUIP 3, LOAD ADDR 

' 'P 0036 0 ' 1Q2 ^ ■ 
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0041 P0037 COOO 


SAN 

JMP<^ 


0060 P0051 0111 
0 061 '^0 05? 18F7 
5 3-„ 0 Q.n p 
0063 ^0054, 1800 
PO 0S5 FFAA 


0065 0060 FOU 

0066 ■“'005F onoi BSS 

--0^67--rPK^5-7--^}B16r4--" ^ ^ 

0068 END 


0058 P004E 0F44 

0059 P004F AOOO 


004P 

0043 


P0039 0800 
P003A 03FE 


P003C 0.1 B1 
P003D 0800 


0045 


0047 

0048 


P003F 0F43 
P0040 AOOO 


P004? 0111. 
P0043 18F7 


0049 

0050 


P0045 0056 P 
P0046 EOOn 


005? 


0053 

0054 


P0048 0800 
P004Q 03FE 


P004O. 0181 
PO04C OBOO 


0056 
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12.7.3.1 Address Tag Program 
Write Addresses: 

Every new disk pack has to have addresses written on it before it can be used for 
data storage. Each sector must have an address tag. The hardware address tag 
switch and the write address function code are for writing the addresses. The 
following program could be used to write tags. 



NAM 

WRITE ADDRESS TAGS 

* 



* 

* 

TURN ADDR TAG SWITCH ON * 

DISK IS EQUIP 3 * 

* 

FOR 854 CHANGE CYL EQU TO $CB * 

* 



* 


EQU 

EQUIP($0182) , C YL($64) 


ENT 

TAGS 


TAGS 

0 

0 



LDA 

=N$0102 

*SEL UNIT 0, CLR INT 


LDQ 

=XEQUIP-1 

*DIR FUNC 


NOP 




OUT 

-1 



INQ 

1 

*SEEK FUNC 010 


ENA 

0 

*ADDRESS 0000 

LOOP 

OUT 

-1 



INQ 

5 

*WRITE TAG FUNC 111 


NOP 




OUT 

-1 



INQ 

-6 

*DUMMY DIR FUNC 001 


ENA 

0 

*LAZY MAN’S BUSY CK 


OUT 

-1 

*FALLS THRU WHEN BUSY 


INQ 

1 

*LOAD ADDR FUNC 010 


NOP 




INP 

-1 

*NEXT ADDR IN A 


EOR 

=XCYL 

*FINISHED? 


SAZ 

EXIT 



NOP 




INP 

-1 

*GET NEXT ADDR BACK 


JMP* 

LOOP 


EXIT 

SLS 


*STOP 


JMP* 

TAGS+1 

*GO DO IT AGAIN 


END 
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Usually the program to write tags is keyed in from the console rather than run in 
assembly language. Therefore, it would be desirable to s ho r ten the program. 
Error checks can be eliminated if the hardware is functioning properly. The 
following code is used by the customer engineers: 

EOOO 
0182 
0 2FE 
0D0 5 
0 3FE 
0DF9 
OAOO 
0 3FE 
18F7 

Decode the program and see what it does. A master clear sets the diskat address 
0000 to begin. The program will stop on alarm when it is finished and is attempting 
to write an address beyond the last cylinder (on an 853 or 854). 


12.7.4 Problem 

Write a program to write zeroes on the entire disk pack after the new address 
tags have been written. Include error checks. 


12.8 1751 DRUM CONTROLLER 

The 1751 Drum Controller interfaces with drums ranging in size from 65,536-jLo words 
to 8, 388,508^0 words. The drum word size is 20 bits composed of 16 data bits, 1 parity 
bit (odd), 1 protect bit and 2 spacing bits. 


19 18 17 16 15 0 


DRUM 



WORD 


DATA BITS 


i 


Spacing ,, 

Parity 



Protect 

The transfer rate for one word is 8 microseconds. All data transfers to and from the 
1700 are via the DAC. The access time for the drum is 8 milliseconds, with a maximum 
of 16 milliseconds. 

The Q Register will be in the following format when addressing the 1751. 

15 11 10 7 3 0 
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The D portion of Q determines the type of information being sent or received in the A 
Register. The INP and OUT instructions, accompanied by the Q setting, control the 
information flow to A (INP) and from A (OUT). 


Figure 32. Interim Drum Interface Codes 


1700 I/O 

CO cq rH O 

o o o o 
O’ O' O’ O' 

DESCRIPTION 

Write 

X X X 1 

Director function 
A^ = Not used 
A^ = 1 Clear Interrupt 
A^ = Not used 

A = 1 End of Operation Interrupt Request 

O 

Write 

0 a b 0 

Initiate Operation 


0 0 0 0 

ab = 00 Write Data From Core 


0 0 10 

ab = 01 Write Zeros 


0 10 0 

ab = 10 Read Data to Core 


0 110 

ab = 11 Check Parity on Drum 

Write 

1 a b 0 

Load Address Register 


10 0 0 

ab = 00 Track 


10 10 

ab = 01 Initial Sector 


110 0 

ab = 10 Initial Core 


1110 

ab = 11 Final Core 

Read 

X X 0 1 

Director Status I 
A^ = 1 Ready 
A^ = 1 Busy 
A^ = 1 Interrupt 
A^ =• Not used 
A^ = 1 End of Operation 
A^ = 1 Not used 
Ag = 1 Lost Data 
A^ = 1 Protected 

A = 1 Parity Error 

A^ = 1 Not used 

A^g = 1 Guarded Address 

A^^ = 1 Timing Track Error 


X X 1 1 

Director Status II 

Ag - A^^ Sector Address 
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12. 8. 1 Drum Functions 

When the D portion equals 000 12 accompanied by an OUT instruction, the A Register 
must be preset. The setting of A determines the function or functions to be sent 
to the 1751. 

3 1 


4 

Clears Interrupt 
EOF Interrupt 

The Clear Interrupt bit clears the interrupt. The EOF INT (End of Operation 
Interrupt) takes precedence over the CLR INT. When the EOF bit is set, the 1751 
will generate an interrupt when it has completed an operation. The remaining 
bits in A are not used, therefore, they should be set to zeros. 

When programming the drum the programmer first clears interrupts. If writing 
in interrupt mode, he should also select the EOF interrupt. 

LDQ =N$0101 EQUIF 2, DRUM FUNC 

ENA $000A CLR INT, SEL EOF 

OUT -1 OUTFUT FUNCTION 

Once the interrupts have been cleared and reselected, the programmer must tell 
the controller the first word address (FWA) of his buffer area in core memory, as 
well as the last word address (LWA) of the core memory buffer. This is accom- 
plished by two D settings: D = IIOO 2 denotes FWA, D = HIO 2 indicates the last 
word address. These settings are accompanied by an OUT instruction with the 
address preset in the A Register. 


LDQ 

=N$010C 

EQUIF 2, FWA 

LDA 

=XFWA 

A = FWA 

NOF 

OUT 

-1 

OUTFUT ADDRESS 

LDQ 

=N$010E 

EQblF 2, LWA 

LDA 

=XLWA 

A = LWA 

NOF 

OUT 

-1 

OUTFUT ADDRESS 


The controller then knows the area and length of the computer buffer area. Once 
the controller knows the memory limits, the programmer must give the drum 
area by sending the beginning track address and sector address. Both are sent 
from the lower 12 bits of the A Register. The D portion of the Q Register dis- 
tinguishes between sector and track address: D = 1000 indicates TRACK, 



12-50 



12 . 8.1 


D = 10 IO 2 specifies sector. The programmer may select any one of 4096 tracks. 
(Note: Not all systems have the maximum number of tracks, therefore, check 
your configuration.) The programmer may select one of 2048 jl() sectors. (A sec- 
tor is the drum address of a word within a track. ) 


LDQ 

=N$0108 

EQUIP 2, TRACK ADDR 

ENA 

$0004 

TRACK 4 

OUT 

-1 

OUTPUT TRACK NUMBER 

LDQ 

=N$010A 

EQUIP 2, SECTOR ADDR 

ENA 

0 

SECTOR 0 

OUT 

-1 

OUTPUT SECTOR NUMBER 


The controller now knows the core memory and drum memory to be used for an 
operation. The programmer must now specify one of four operations. The op- 
erations are also indicated by the D setting of the Q Register in conjunction with 
an OUT instruction. The four operations are as follows; 

D = 0000^ initiates a write operation. This write operation instructs the 
1751 to write data on the drum from core memory. 

D = OOIO^ instructs the 1751 to write zeros on the designated drum area. No 
data is transferred from memory. 

D = ^2 iiiitiates a read operation. The read operation transfers data 

from the drum to core memory. 


D = OllO^ initiates a check operation. The check operation causes the 
designated drum area to be read and checked for parity errors 
without any transfer of data into core memory. 


LDQ 

NOP 

=N$0100 

EQUIP 2, 

WRITE 

OUT 

-1 

INITIATE 

WRITE 

LDQ 

NOP 

=N$0102 

EQUIP 2, 

WRITE ZEROS 

OUT 

-1 

INITIATE 

ZERO WRITE 

LDQ 

NOP 

=N$0104 

EQUIP 2, 

READ 

OUT 

-1 

INITIATE 

READ 

LDQ 

NOP 

=N$0106 

EQUIP 2, 

CHECK 

OUT 

-1 

INITIATE 

CHECK 
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The drum at this point will be in the process of performing an operation. If the 
END OF OPERATION interrupt were selected, the 1751 will generate an interrupt 
when the operation is completed. 


12. 8. 2 Drum Status 

The programmer may take status while the operation is being performed in order 
to monitor the progress of the operation. He may also take status again at the end 
of the operation to verify an error free operation. 


12, 8, 2. 1 Director Status I 

Status maybe requested by a D setting of OOOI2 accompanied by anINP instruction. 
The status will be brought into the A Register. 


LDQ 

NOP 

1 =N$0101 

EQUIP 2, DIRECTOR STATUS 

INP 

-1 

BRINGS STATUS INTO A 


15 

14 

13 

12 

11 

10 

9 

8 

7 

6 

5 

4 

3 

2 

1 

0 


xOi: 



1 

1 



1 

1 


1 


1 

1 

■ 


Timing Track Error 


4 


^ I 

Parity 

Error 


4 

Lost 

Data 


EOP 


4 

INT 


t t 

I Ready 
Busy 


Guarded Address 


Protected 



A 1 in the corresponding bit indicates that the stated status exists. For example, 
a 1 in bit 11 indicates a timing track error. 

Timing Track Error 

Bit 11 is an error in the timing track which insinuates a hardware problem. 
The programmer should attempt the operation three or four times before 
accepting the status as a hardware failure. 

Guarded Address 

Bit 10 indicates that a core to drum transfer was attempted to a track with an 
address lower than the one set on the track protect switch. 


Parity Error 

Bit 8 indicates that the parity was not odd, i. e. , it did not have an odd num- 
ber of one bits in the word. 
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Protect 

Bit 7 indicates that the protect switch on the drum has been set. 

Lost Data 

Bit 6 indicates that data was not transferred from the controller’s holding 
register before new data was read into the register. 

EOP 

Bit 4 notifies the programmer that an operation has been completed. 

Interrupt 

Bit 2 indicates that an interrupt has been generated by the 1751. 

Busy 

Bit 1 indicates that the 1751 is in the process of performing an operation. 
Ready 

Bit 0 indicates that the controller is in a ready state. 

12.8.2.2 Director Status II 

The programmer may also request the 1751 to send the current sector address of 
the drum to the lower 12 bits of the A Register, This is accomplished by setting 
D = 0011 and executing an INP instruction. 


LDQ 

NOP 

=N$0103 

EQUIP 2, SECTOR STATUS 

INP 

-1 

INPUT SECTOR ADDRESS 


12. 8. 3 Programming the Drum 

In summary, the programmer must first clear interrupts and select desired inter- 
rupts. Once this has been issued, the programmer notifies the 1751 of the first 
word address and the last word address of core memory. Then, he must send 
the track and sector addresses of the drum. Pinally, he specifies the operation 
to be performed. Status may be taken during the operation to monitor the pro- 
gress and should be taken at the end of the operation to confirm that the operation 
was performed correctly. 

When data is being written on or read from the drum, the track address is auto- 
matically incremented when the sector address overflows to the next track. 
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Also, the Write Zeros and Check Parity functions operate on a specified area of 
the drum. Since only a beginning track and sector address were specified, the 
core address must be sent also to indicate the number of words, even though the 
data in core is not involved in those operations. 

Example : 

The following is a test program for the drum. It writes 100 words from a buf- 
fer beginning at FWA, on the drum beginning at track 4, sector 0. It then checks 
drum parity on the data written and reads it back in. 

To operate the program, the initial buffer should be set to all one bits from the 
console. The STOP switch should be set, and the program will stop before the 
Read. The buffer should then be cleared from the console. By setting the STOP 
switch again and continuing the RUN, the read will be done and the program will 
stop. Then the buffer can be swept from the console to see that the data was read. 

Note that the drum controller must be dialed to equipment #2 and that the drum 
address registers and memory address registers must be reset before each 
operation. 

Note also the nifty coding at lines 0026 - 0030 to jump different places on a flag. 
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12.8.4 Drum Example Program 




— 000-1- 
0002 
0003 

P 0 0 0 0 

0 0 <' 0 


DRUM 



ENT 

0 

DRUM 

DRUM 

f) 


0004 

POOOl 

OAOl 



ENA 

1 

FIRST JMP TO WRITE 

0005 

P0002 

6« 1 F 



Qf A^^ 

FL AR 


0006 

P0003 

0A0 2 



ENA 

S0002 

CLEAR CONTROL 

0007 

P0 004 

EOOO 



LDQ 

=mtoi n 1 

T?r»TTTT) O -nTT? ITTT-NTr' 










P0005 

0101 






nnnp 

POOO^ 

npon 



MOP 



0009 

P0007 

03FE 



OUT 

-1 


no T n 

pnnoR 

rnnn 


MFM 

\ HA 

= XFWA 

■RTTFFFU 


P0009 

0 03E 

P 





nni 1 

pnon A 

Foon 



L no 

=M<?;m or. 

FWA(CORE) FUNC 


POOOH 

OlOC 






0012 

POOO^ 

OHO 0 



MOP 



0013 

POOOD 

0 3FE 



OUT 

-1 


no 1 

PQOf^f 

r n 0 1 1 



1 HA 

=XFWA+99 

LWA 


POOOF 

OOAl 

P 





00 1 

POO 1 0 

EOOO 



LDQ 

=M$0 1 nF 

T,WA(COT?F^) FTTNC! 


POOH 

OlOE 






0016 

POO 1 2 

OBOO 



MOP 



0017 

POOH 

03FE 



OUT 

-1 


00 1 P 

POO 1 4 

cooo 


ADOR 

LDA 


TRACK 


POOIB 

0 0 04 






nni q 

pool 6 

Fono 



1 no 

=M.<fini 08 

TRACK ADDR FUNC 


POOH 

0108 






0 020 

PO 0 1 8 

OBOO 



NOP 











0021 

P0019 

03FE 



OUT 

-1 


nnpp 

POO 1 A 

rnnn 



1 OA 

=MO 

SECTOR 


POOIB 

0000 






nnp'i 

Pom r 

Fonn 



1 no 

=MTni OA 

SECTOR ADDR FUNC 


POOID 

OlOA 






0024 

pool F 

n R n n 



MOP 



0025 

POOIF 

03FE 



OUT 

-1 


0026 

P0020 

1 rnn 



MUM 

SI coo 

JMP* 101 

0027 

P0021 

0000 


FLAG 

0 

0 

WHERE TO JUMP 

002R 

P0022 

0 0 25 

_E_ 


Anc 

WRTTF 


0029 

P0023 

0033 

P 


ADC 

CHECK 


0030 

P0024 

0 0 38 

P 


Anc 

RFAn 


0031 

P0025 

OAOO 


WRITE 

ENA 

0 


nn32 

Pon2R 

Fonn 



1 no 

=Msn 1 nn 

WRITE DATA 


P0027 

0100 






nn33 

P002R 

n H n n 



MOP 



0034 

P0029 

03FE 



OUT 

-1 


nniR 

POO 2 A 

Fonn 


5TAT 

LOO 

sMsni n 1 

DIR FUNC 


P002B 

0101 






no3R 

Pon2r 

ORon 



MOP 



0037 

P002D 

02FE 



INP 

-1 

INP STATUS 

on3R 

P0 0 2F 

OFFR 



Al 5 

1 1 

CK EOP 

0039 

P002F 

0131 



SAM 

1 

SKIP ON EOP 

0040 

P0030 

1 HFr 



.IMP* 

STAT+3 

WATT ON KOP 

0041 

P0031 

D8EF 



RAO<^ 

FLAG 

NEXT JMP 

0042 

P0032 

1 8Ij5 



.IMP* 

MFM 

cn RFINITIAIJ7F 

0043 

P0033 

EOOO 


CHECK 

LDQ 

=N$0106 

CK PAR ERR ON DRUM (ONLY) 


PQQ34 

0106 
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0045 

f\ r\ 

PQ03b 

P0036 

n n A -7 

OBOO — 
03FE 

1 a l: n 


!4©P 

OUT 

-1 
T A T 

GO WAIT ON FOP 

0047 

n n/. D 

r U J t 
P0036 

n n m n 

lore 

OOUO 

c n n r\ 

READ 

Jnl 

SLS 

I nn 

J 1 M 1 
0 

— MO. n 1 i\/. 

CLEAR BUFFER FROM COM! 

T?pAr> ■p’TTNr 

n A /. a 

P003A 

tan mu 

0104 

n u n f\ 


MOP 



0050 

n c 1 

P003C 

nn mn 

03FE 

n /wi A 


OUT 

Cl c 

-1 

QT'nU ATT’T'PT? T?T?AF» 

0052 

-0053 

P003E 

00b4 

FWA 

BZS 

ENO 

FWA (100) 

mm 

SET BUFFER TO IV 


T 

A CT r 


f\i-\r\riD 


nnnQD 

Anno 

n m AD 

FI AO 

0021P 

WRITE 

0025P 

STAT 

002AP 

CHECK 

0033P 

READ 

0038P 

FWA 

003EP 













La Jolla.- September 1968 
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U 

12.9 1731/601 MAGNETIC TAPE 

The 1731 magnetic tape controller is used with 601 tape transports. A maximum of 
eight 601's may be connected to one 1731. Buffering may be accomplished via the 1706. 

The 601 is a 7-track transport capable of reading or writing at 200 or 556 Bits Per 
Inch (BPI). The tape is moved at a rate of 37 1/2 inches per second. 

Reading and writing may be done in either Binary or BCD codes. The 601 accepts six 
bits of data and generates parity for the 7th bit. The parity will be odd for binary and 
even for BCD. 

The data is arranged in groups of records and files. Consecutive frames of information 
constitute a record. A record may consist of a minimum of one frame. A file is a 
group of records with the minimum being one record. Longitudinal parity (even) is 
generated on each record and stored four spaces past the last data character. A record 
gap is 3/4' of unrecorded tape surface which denotes the end of a record. A BCD 17^ 
code is placed six inches from the last record to indicate the end of a file. 

Each time a character is written by a 601, it transfers the character to the 1731 which 
checks the parity. If the parity is incorrect, the Parity Error status is set and an 
alarm interrupt is generated. (Note: The alarm interrupt will be generated only if the 
programmer has selected this interrupt.) The controller also checks for correct parity 
on a read operation. 

The Q Register will be in the following format when programming the 1731. 

15 11 10 7 6 2 1 0 

Q 


The W field will always be zero when going to the 1731. This field will be used for 
programming the 1706 which will be discussed later. The E specifies the equipment 
number of a 1731. The equipment number corresponds with a switch selection on the 
1731 ranging from 0 to $F. (Check the equipment setting for your site.) The D field 
specifies a command. 




12.9.1 D = 00 MT Data 

This setting specifies a data transfer, A write operation is indicated by an OUT 
instruction. The write sends the lower six bits of A to the 1731 which generates 
parity and writes the data and parity on the tape. Whenever the computer breaks 
the continuity of the character outputs, the controller initiates an End of Record 
sequence, if no new control functions are issued after the end of record is re- 
corded, tape motion stops. 

An INP instruction with D = 00 denotes a Read operation. The read operation 
transfers data from the tape to the controller. The controller checks parity and 


12-57 




12.9.1 


sends the 6 data bits to the lower 6 bits of the A Register. The 1731 stops sending 
data to the computer when the computer stops requesting data or when the End of 
Record is sensed. Tape motion will not terminate except when the End of Record 
gap is sensed. 

If the 1731 is connected to the 1706, the data will be buffered into the computer's 
memory. The lower six bits of each word in the buffer area will contain data. 
The A Register will contain the FWA-1 of the buffer area for both read and write 
operations, therefore, the data transfer will always be initiated with an OUT 
instruction. The FWA-1 in memory must contain LWA+1 of the buffer area. 
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Figure 33, 1731 Functions 


D 

COMPUTER INSTRUCTION 

Output from A 

Input to A 

00 

Write 

Read 

01 

Control Function 

Director Status I 

10 

Unit Select 

Director Status II 


(A) 


- Control Function 


MOTION CONTROL 
NOT USED I 


NOT USED 

ALARM INTERRUPT REQUEST 

END OF OPERATION INTERRUPT REQUEST 
DATA INTERRUPT REQUEST 
CLEAR INTERRUPT 
1 CLEAR CONTROLLER 
i i i 


15 1 1 

10 

7 

6 

5 

4 

3 

2 

1 0 


Bits 10-7 
of A 

Motion Function 

0001 

Write Motion 

0010 

Read Motion 

0011 

Backspace 

0101 

Write File Mark 

1000 

Rewind Load 

1100 

Rewind Unload 


(A) - Unit Select Function 


TAPE UNIT 0 - 7 
SELECT TAPE UNIT 
DESELECT TAPE UNIT 

NOT USED^ I ^ ,, 


pNOT USED 

pSELECT 200 BPI 
rSELECT 556 BPI 




SELECT 800 BPI 
BINARY 
I BCD 


♦ 


j ^NOT USED 


15 

12 

1 1 

10 

9 

7 


5 

4 

3 

2 

1 

0 
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12, 9. 2 MT Functions 


12. 9. 2,1 D = 01 Control Function 


This D setting, accompanied by an OUT instruction, indicates that the A Register 
contains control functions. The control function gives the programmer the capa- 
bility of clearing interrupts, clearing the controller, selecting interrupts, and 
establishing motion control. All control functions may be issued together. The 
programmer is allowed to select three interrupts: Data, Alarm and End of 
Operation. 


15 


11 10 


76543210 


Motion Control 


I I I I 

A ▲ ▲ A 4 

c 


CLR Controller 
CLR INT 
Data INT 
EOF INT 
Alarm 


0001 Write Motion 

Sets the write logic in the selected 601. Once the logic is set, a data 
transfer function must be sent with an OUT instruction in order for 
the data to actually be written on tape. 





0010 Read Motion 

Sets the read logic within the selected 601. A data transfer function 
must be sent with an INF instruction in order for the data to be trans- 
ferred to the A Register. 

0011 Backspace 

Causes the 601 to backspace one record. 


0101 Write File Mark 

Write file mark generates six inches of blank tape followed by a 17 g. 
When the end of file mark is written or read, longitudinal parity is 
checked. If the controller is in binary mode, a parity error will be 
generated, as the 17g is in BCD mode (even parity). 


1000 Rewind Load 


The rewind controls bring the tape back to the magnetic load point 
indicator. The ready status stays up without any manual intervention. 


12-60 



12.9.2.1 


1100 Rewind Unload 

The rewind load keeps the ready status while the rewind unload causes 
the 601 to drop ready. 


12. 9.2.2 D = 10 Unit Select Function 


Allows the programmer to select the desired 601, density, and mode, when ac- 
companied by an OUT instruction. The 601 tape units can read at 200 and 556 BPI. 
The deselect function, bit 11, is used to deselect a protected 601 in order that an 
unprotected program mayget access to the 1731 to use an unprotected 601. 


15 


12 11 10 9 


J I 


Deselect Tape Unit 

Select Tape Unit 

Tape Unit 0-7 ' 


6 5 4 3 


Bits in A 
Register 


BCD 
Binary 

Select 800 BPI 
Select 556 BPI 
Select 200 BPI 


The Select Tape Unit, Bit 10, indicates that the unit number in Bits 9-7 is to be 
the desired unit. If Bits 10 and 11 are not set, the controller ignores Bits 7-9. 

12. 9. 3 MT Status 
12.9.3.1 D="01 Status I 

This D setting brings Director Status I into the A Register when accompanied with 
an INP instruction. 

15 13 12 11 10 9 8 7 6 5 4 3 2 1 0 

A II I I 

t t t t t t 

Controller Active • 

File Mark 
Load Point 
End of Tape 

Parity Error 

Protected 


I t 

I Ready 
Busy 
Interrupt 
Data 

End of Operation 
Alarm 
Lost Data 
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12. 9.3.2 D = 10 Status II 

Director Status II is requested with this D setting on an INP instruction. 


A 


15 


5 4 3 2 1 0 



J 


Write Enable 

Seven Track — ' 


I 556 BPI 
800 BPI 


12.9.4 Magnetic Tape Example Programs 
12. 9.4.1 MT Example 1 

The following is a test program for a 601 magnetic tape on a 1731 controller. (It 
could also be used for a 608 tape on a 1732 controller. ) The program generates 
200 frames of data in the A Register and outputs 1 frame at a time (the lower 
order 6 bits of A) to the tape unit. The program then backspaces the tape and 
reads the data back in, storing it in the buffer DATA. Each frame of data oc- 
cupies the lower 6 bits of a word in the buffer. 

The program can be run with the STOP switch set. It will stop when finished, and 
the buffer can be swept from the console. One cannot "step through" the program 
because the tape is moving as soon as the first tape motion command is issued. 
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12.9.4.1 



USEL 


WRITEMO 


DATA 


BACKSP 


o 

READMO 


RDDATA 


STOP 

DATA 



NAM 

MT601 



LDQ 

=N$0382 

Q382 

EQUIP 7, UNIT SEL 

LDA 

=N$0494 


UNIT1,556BPI,BIN 

NOP 




OUT 

-1 



INQ 

-1 

Q381 

MOTION FUNC 

LDA 

=N$81 


WRITE MOT, CLR CONT. 

NOP 




OUT 

-1 



LDA 

=N-200 


200 FRAMES 

STA- 

I 



INQ 

-1 

Q380 

DATA FUNC 

LDA 

=N$FF 


DATA 3F 

NOP 




OUT 

-1 



RAO- 

I 



LDA- 

I 



SAZ 

BACKSP 



JMP* 

DATA+3 



INQ 

1 

Q381 

MOTION FUNC 

LDA 

=N$0180 


BACKSPACE 

NOP 




OUT 

-1 



LDA 

=N$0100 


READ MOTION 

NOP 




OUT 

-1 



LDA 

=N-200 



STA- 

I 



INQ 

-1 



NOP 


Q830 

DATA FUNC 

INP 

-1 



STA* 

DATA+200,1 


STORE DATA 

RAO- 

I 



LDA- 

I 



SAZ 

STOP-*-l 



JMP* 

RDDATA+1 



SLS 

0 


SWEEP BUFFER TO CHECK 

BZS 

DATA(200) 




END 
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12, 9.4. 2 MT Example 2 - With Error Checks 

This test program for magnetic tape is the same as Example 1, with the addition 
of error checks. Note that the program never hangs in a loop on a reject. 

NOP 

OUT -1 

Instead it jumps to REJINT for any internal reject or REJEXT for any external 
reject. Even with no error analysis, note that considerably more coding is 
required just to allow for errors. Also note that the program is continually 
waiting for the tape. 

The program will stop either on normal termination or after a reject. It can be 
restarted after a reject by simply correcting the error condition and setting the 
RUN switch. 

This particular program has been run with the 1706 code set but it is still an un- 
buffered operation. The site where it was run had their magnetic tapes connected 
through the 1706, but the Direct Storage Access line was not also connected so 
operations simply went through the 1706 in unbuffered mode. 
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12.9.4.2 



/ 


0001 




NAM 

TEST 




0002 

POOOO 

EOOO 

A 

LDQ 

=N$1382 





POOOl 

1382 







0003 

P0002 

COOO 


LDA 

=N$0494 

Select 

J 



P0003 

0494 







0004 

P0004 

0302 


OUT 

2 




0005 

P0005 

1804 


JMP*^ 

A2 




0006 

P0006 

586A 


RTJ* 

REJINT 




0007 

P0007 

5861 


RTJ* 

REJEXT 




0008 

P0008 

18F7 


JMP* 

A 



r 

0009 

P0009 

EOOO 

A2 

LDQ 

*NS1381 





POOOA 

1381 







0010 

POOOB 

COOO 


LDA 

=NS0081 

/rite 




POOOC 

0081 





< 


0011 

POOOD 

0302 


OUT 

2 

/lotion 



0012 

POOOE 

1804 


JMP» 

A4 




0013 

POOOF 

5861 


RTJ* 

REJINT 




0014 

POOlO 

5858 


RTJ<^ 

REJEXT 




0015 

POOH 

18F7 


JMP<^ 

A2 



0016 

P0012 

COOO 

A4 

LDA 

=N-200 





P0013 

FF37 







0017 

P0014 

60FF 


STA- 

I 



r 

0018 

P0015 

EOOO 

A5 

LDQ 

=N$1381 





P0016 

1381 






1 

0019 

POOH 

0202 


INP 

2 

Status 

< 


0020 

P0018 

1804 


JMP* 

A55 




0021 

POOH 

5857 


RTJ* 

REJINT 




0022 

POOIA 

584E 


RTJ* 

REJEXT 




0023 

POOIB 

18F9 


JMP* 

A5 



r 

0024 

POOIC 

OFCC 

A55 

ALS 

12 




0025 

POOID 

0131 


SAM 

*♦2 

Data 



0026 

POOIE 

18F6 


JMP<^ 

A5 

Ready? 

< 


0027 

POOIF 

ODFE 


I NO 

-1 




0028 

P0020 

COOO 


LDA 

»NSFF 





P0021 

OOFF 






r 0029 

P0022 

0305 

OUT 

OUT 

5 




0030 

P0023 

DOFF 


RAO- 

I 




0031 

P0024 

COFF 


LDA- 

I 




0032 

P0025 

0104 


SAZ 

A7-*-l 

Output 

> 


0033 

P0026 

18EE 


JMP* 

A5 

Data 

s 


0034 

P0027 

5849 


RTJ<^ 

REJINT 




0035 

P0028 

5840 


RTJ" 

REJEXT 




0036 

P0029 

1BE0 


JMP<^ 

A5 




0037 

P002A 

EOOO 

A7 

LDQ 

*N$1381 





P002B 

1381 







0038 

P002C 

0205 


INP 

5 




0039 

P002D 

AOOO 


AND 

*N$2 





P002E 

0002 




Busy? 

< 


0040 

P002F 

0104 


SAZ 

A9-tt-l 




0041 

P0030 

18F9 


JMP» 

A7 




0042 

P0031 

583F 


RTJ* 

REJINT 




0043 

P0032 

5836 


RTJ» 

REJEXT 




0044 

P0033 

18F6 


JMP* 

A7 




0045 

P0034 

EOOO 

A9 

LDQ 

*N$1381 





P0035 

1381 





1706 

EQUIP 7 
UNIT SEL 

UNIT 1, %%<? BPI, BINARY 
GOOD 

INTERNAL REJECT 

EXTERNAL REJECT 
RETURN AFTER REJECT 

CONTROL FUNCTION 

WRITE MOT - CLR CONTROL 


EOR 200 FRAMES 

DIR ST AT 1 
STATUS 

DATA READY? 

WRITE DATA FUNC 
0000 0000 1111 1111 


GO STATUS AGAIN FOR DATA READ’i 

DIR STATUS 1 

CHECK BUSY 

SKIP WHEN NOT BUSY 


CONTROL FUNCTION 
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12.9.4.2 




r 

0046 

P0036 

COOO 





P0037 

0180 




0047 

P0038 

0302 

Backspace 

< 


0048 

P0039 

1804 



0049 

P003A 

5836 




0050 

P003B 

5820 



K. 

0051 

P003C 

18F7 



r 

0052 

P003D 

EOOO 





P003E 

1381 




0053 

P003F 

0202 




0054 

P0040 

1804 




0055 

P0041 

582F 

Busy? 



0056 

P0042 

5826 


0057 

P0043 

1801 




0058 

P0044 

OFCE 




0059 

P0045 

0121 




0060 

P0046 

18F6 




0061 

P0047 

COOO 



r 


P0048 

0100 

Read 



0062 

P0049 

0302 

Motion 



0063 

P004A 

1804 


0064 

P004B 

5825 




0065 

P004C 

581C 



w 

0066 

P004D 

18EF 



f 

0067 

P004E 

COOO 

E-7 


1 


P004F 

FF37 


1 

L 

0068 

P0050 

60FF 



r 

0069 

P0051 

EOOO 





P0052 

1381 




0070 

P0053 

0202 




0071 

P0054 

1804 

Data 

< 


0072 

P0055 

581B 


0073 

P0056 

5812 

Ready? 



0074 

P0057 

18F9 




0075 

P0058 

OFCC 




0076 

P0059 

0131 



> 

0077 

P005A 

18F6 



0078 

P005B 

ODFE 




0079 

P005C 

OAOO 




0080 

P005D 

0207 




0081 

P005E 

6900 

Input 

< 



P005F 

00E2 

Data 


0082 

P0060 

DOFF 




0083 

P0061 

COFF 




0084 

P0062 

0104 




0085 

P0063 

18ED 




0086 

P0064 

580C 




0087 

P0065 

5803 




0088 

P0066 

18EA 



r" 

0089 

P0067 

0000 




0090 

P0068 

0000 

External 



0091 

P0069 

EOOO 

Reject 

< 

1 


P006A 

1381 




0092 

P006B 

OBOO 



L 

0093 

P006C 

02FE 



LDA 

*NS0180 


OUT 

2 


JMP<^ 

All 


RTJ* 

REJINT 


RTJ* 

REJEXT 


JMP* 

A9 

All 

LDQ 

=N$1381 


INP 2 



JMP» 

Alll 


RTJ* 

REJINT 


RTJ* 

REJEXT 


JMP* 

Alll 

Alll 

ALS 

14 


SAP 

*♦2 


JMP* 

All 

LOA 

=N$0100 


OUT 

2 


JMP* 

A13 


RTJ* 

REJINT 


RTJ<^ 

REJEXT 


JMP« 

All 

A13 

LDA 

=N-200 


STA- 

I 

A14 

LDQ 

=N$1381 


INP 

2 


JMP<» 

A44 


RTJ* 

REJINT 


RTJ* 

REJEXT 


JMP* 

A14 

A44 

ALS 

12 


SAM 

*♦2 


JMP* 

A14 


INQ 

-1 


ENA 

0 


INP 

7 


STA 

DATA^200 


RAO- 

I 


LDA- 

I 


SAZ 

A16-*-l 


JMP* 

A14 


RTJ* 

REJINT 


RTJ* 

REJEXT 


JMP* 

A14 

A16 

SLS 


REJEXT 

0 

0 


LDQ 

*N$1381 


NOP 



INP 

-1 


BACKSPACE 


Dm STATUS 1 


BUSY? 

SKIP WHEN NOT BUSY 
SEL READ MOTION 


STATUS 

WAIT FOR DATA READY 
INPUT DATA 

I STORE DATA NOT 

ASSEMBLED 


STOP WHEN THROUGH 

EXT REJ 

TAKE STATUS 
AND STOP 
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12.9.4.2 


0094 

P006D 

E8FA 


LDQ* 

REJEXT 


0095 

P006E 

0000 


SLS 

0 

RUN TO RETURN 

0096 

P006F 

1CF8 


JMP* 

(REJEXT) 


0097 

P0070 

0000 

REJINT 

0 

0 


0098 

P0071 

EOOO 


LDQ 

*NS1381 

INTERNAL REJECT 


P0072 

1381 




TAKE STATUS 

0099 

P0073 

OBOO 


NOP 


0100 

P0074 

02FE 


INP 

-1 

AND STOP 

0101 

P0075 

E8FA 


LDQ* 

REJINT 

RUN TO RETURN 

0102 

P0076 

D8F9 


RAO* 

REJINT 


0103 

P0077 

0000 


SLS 

0 


0104 

P0078 

1CF7 


JMP* 

(REJINT) 

DATA BLOCK 

0105 

P0079 

00C8 


BZS 

DATA(200) 

0106 




END 




o 


Lockheed - September 1968 
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12.10 


12.10 1732/608-609 MAGNETIC TAPE 

The 1732 controller for 608 and 609 Magnetic tapes is very similar to the 1731 and can 
be programmed in identically the same way as the 1731. For that reason, a separate 
program for the 1732 is not included here. Instead, the 1731 program was run on the 
1732/608. 

The 1732 provides an additional feature which was not available on the 1731: option for 
selecting as sembly/dis assembly mode. This means that two frames at a time can be 
sent to or received from the controller in one OUT or INP (consequently meaning the 
controller has to be accessed half as often). The controller takes care of assembling 
or disassembling the frames on the tape. Bit 6 (not used on the 1731) in the function 
code is used to select this mode. 

This is especially useful on the 609 (9- track tape) in that two 8-bit frames exactly fit 
in one 16-bit 1700 word. Repacking the buffer can be eliminated since a word at a 
time is sent to the controller. The 609 uses only 800 BPI density, and normal end of 
files are not used on it. For example: 

• Load 601 MT program from lockheed (or reassemble with changes) 

• Clear 1706 code from all Q addresses - MT's are not on 1706 (i. e. , change $1382 
to $0382) 

• Change P0003 to: 

$4D4 for 608 (adds selection of assembly) 

$4CC for 609 (800 BPI only, assembly) 

• Change P0021 to FFFF 

• Follow operating instructions on 601 program 

• Output from A will be (in assembly/disassembly): 


608 - bits 8-13 and 0-5 

XX 1 1 1 1 

1 1 XX 1 1 1 1 

J 


609 - bits 8-15 and 0-7 

1 1 1 1 1 1 

1 1 1 1 1 1 1 1 

III 

Input to A will be: 




608 

00 1 1 1 1 

1 1 00 1 1 1 1 

in 

609 

i i 1 i 1 1 

1 1 1 1 1 1 1 1 

13 


• The upper bits in A are the first frame; the lower bits are the second frame. 

12. 11 1706 BUFFER DATA CHANNEL 

The 1706 is a 16-bit, bidirectional, buffer channel with word transfer rates up to 
900 KC (approximately 1. 1 microseconds per 16-bit word). 

The 1706 buffers data between the computer’s memory and a peripheral. The 1706 is 
capable of buffering as many as eight devices. The 1700 system may have three 1706’s 
attached. 
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12.11 


The 1706 has no indicators nor control panels, therefore, all operations are initiated 
by the computer viatheA/Q channel. The 1706 is considered as one of the eight devices 
attached to the A/Q channel and the DSA channel with each peripheral connected to the 
1706 being a substation. Consequently, only one of the 1706’s peripherals may be 
referenced at a time. 


The program requests direct access to a peripheral via the 1706 to establish the logic. 
Once the logic has been established, the program requests the 1706 to perform the data 
transfer. 

Bits 11-15, the W field, of the Q Register are used to reference the 1706 and to indi- 
cate the desired operation. Bits OrlOof the Q Register will contain the same bit setting 
used to reference a particular peripheral when it is not attached to the 1706. 


15 


11 10 


7 6 


Q 



w 




J 


E 


D 


1706 


Peripheral 


It is possible to perform direct I/O on a device connected to the 1706 simply by setting 
W to 00010 and sending all the codes for the device thru the 1706. (However, normally 
if a device is on the 1706, it is desired to perform data transfers in a buffered mode 
by letting the 1706 perform the operations.) 


12. 11. 1 1706 Functions 

The setting of the W field is dependent upon which of the possible three 1706's the 
program is referencing. There are four settings for each 1706. 


W SETTING* COMPUTER OPERATION 


1706 

1706 

1706 



#3 

#2 

#1 

INP 

OUT 

oC 

o7 

o2 

Direct Input 

Direct Output 

oD 

o8 

o3 

Terminate Buffer: 
Current Addr of 1706 

Function 

oE 

o 9 

o4 

1706 Status 

Buffered Output 

oF 

0 A 

o5 

1706 Current Addr 

Buffered Input 


*The left digit is binary, the right digit is hexadecimal. 
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12 . 11.1 


The first W setting provides the computer direct access to the peripheral. The 
peripheral may be requested to send to the A Register a data word or status word. 
The computer may send to the peripheral a function or data word from the A Reg- 
ister. This mode of operation is identical in every way to that on the A/Q channel. 

12. 11. 2 Programming the Peripheral Through the 1706 

The 609 magnetic tape imit shall be used as an example with 1706 number 1. It is 
necessary to set up the equipment prior to telling the 1706 to do any l/O on the 
equipment. 


LDQ 

=N$1202 

DIRECT OUT 

LDA 

=N$4CC 

SEL UNIT 1, ASSEMBLY, 
800 BPI, BIN 

NOP 



OUT 

-1 


INQ 

-1 

PREPARE FOR TAPE MOTION 

LDA 

=N$80 

WRITE MOTION 

NOP 



OUT 

-1 



The 609 tape unit has now been functioned. The next step is to function the 1706, 
requesting it to interrupt the computer when the data transfer is complete. (This 
is if the 1706 will be operated in interrupt mode.) 


LDQ 

=N$1800 

1706 FOR FUNCTION #3 

LDA 

=N$8001 

INT ON EOP 

NOP 



OUT 

-1 

1706 IS FUNCTIONED 

The 1706 and the 

peripheral have both been functioned. The next step is to initiate 


the I/O operation. At this point the 1706 will take over and do the data transfer. 
It will now be impossible to directly access the peripheral until the 1706 is finished 
or becomes hung up. 

The 1706 expects to find the First Word Address minus one (FWA-1) of the buffer 
area in the A Register when the l/O operation is initiated. Upon receiving the 
FWA-1 the 1706 goes into the computer’s memory and extracts the Last Word Ad- 
dress plus one (LWA+1) from that location. The 1706 then updates the FWA-1 by 
1 until it equals the LWA+1 at which point the data transfer is complete. 
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EDA 

STA 

LDQ 

LDA 

NOP 

OUT 

=XLWA+1 

FWA-1 

=N$2200 

=XFWA-1 

-1 

LAST WORD ADDR + 1 IN A 
LWA=1 AT FWA-1 
BUFFER OUT. EQUIP #4 
FWA-1 IN A 

OPERATION INITIATED 

The program at this point may exit and wait for the End of Operation interrupt. 
Two other alternatives are available: status for End of Operation or status for 
current address. 


LDQ 

=N$2200 

STATUS 1706 


NOP 



STAT 

INP 

-1 

STATUS IN A 


ALS 

11 

EOP BIT AT SIGN BIT 


SAM 

CMP 

WHEN SET OP COMPLETE 


JMP* 

STAT 

WAIT UNTIL COMPLETE 

CMP 

- 

- 



LDQ 

=N$2A00 

CURRENT ADDR, EQUIP 4 


NOP 



STADR 

INP 

-1 

CURRENT ADDR IN A 


SUB 

=XLWA+1 

SUBT LWA+1 


SAZ 

CMPl 

ZERO, OPERATION CMP 


JMP* 

STADR 

CONTINUE STATUS FOR ADDR 


CMPl 


12.11.3 1706 Status 

Once the data transfer is complete, the program may process the data. The pro- 
gram may at any time status the 1706 for the current address and for the 1706 
status word. The program may check the status word for the following information. 


A 


15 


10 9876543210 



Device Reply | 

Device Reset 
Program Protect Fault 


4 

EOP 


t t ^ 

I Ready 
Busy 
Interrupt 


o 
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Note that this is the status of the 1706, not the peripheral. It is not possible to 
get the status of the peripheral while the 1706 is working on it. 


Ready (Bit 0 = 1) 
Busy (Bit 1 = 1) 


Interrupt (Bit 2 = 1) 


Program protect fault (Bit 6=1) 


Device Reject (Bit 8 = 1) 


Device Reply (Bit 9 = 1) 


This bit is set when power is on. 

This bit is set from the time the 1706 accepts 
an output word from the computer initiating a 
block transfer until the block transfer is ter- 
minated, or during a direct operation. 

A buffer transfer input or output has been com- 
pleted. 

A reference to computer storage caused a pro- 
gram protect fault. 

This bit, if set, means the peripheral device 
rejected the last word transfer attempted from 
the 1706. 

This bit, if set, means the peripheral device 
accepted the last word transfer attempted from 
the 1706. 


It is possible for the 1706 to get hung up as it continually repeats an attempt to 
make a data transfer to the peripheral if the peripheral fails. 

The program may status and find a Device Reject status. If this condition were to 
arise, the program may terminate the buffer operation. This termination is 
always necessary when the buffer becomes hung up. When the operation is ter- 
minated, the current address is sent to the A Register automatically. 

LDQ =N$1A00 TERMINATE BUFFER, EQUIP 4 

NOP 

INP -1 CURRENT ADDR IN A 


12. 11. 4 Summary of 1706 


In summary, the computer functions the peripheral direct via the 1706. Once the 
peripheral is functioned, the End of Operation interrupt is requested. The program 
must have the LWA+1 at the FWA-1 prior to initiating a buffer operation. When 
the buffer operation is initiated, the FWA-1 is in the A Register and sent to the 1706. 
The status word of the 1706 may be requested anytime as well as the current ad- 
dress. The program cannot status the peripheral itself until the operation is 


completed or terminated. 
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12.11.5 


12.11.5 1706 Example Program 
Example: 

The following is a test program for a 609 magnetic tape on a 1732 controller, op- 
erated in buffered mode by the 1706. The program outputs 50 words of data from 
the buffer beginning at BUF+1, rewinds the tape, and reads the data back in. 

The buffer should be set to all one bits from the console. Then the program should 
be operated with the STOP switch set so that the program will stop after writing 
(to allow the programmer to clear the buffer from the console) . After reading, 
it will stop again where the buffer can be swept to see the data. 
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0002 

0003 


1 


ENT 
FO' 1 

MT 

01 If 04 ( onn ) 

■niPFCT OTTT 

0004 

0005 


18u0 

?'''O0 


EQU 

EQU 

FUN06(S1800) 
pi IFM4 ( <Rpoon ) 

FUNCTION 

mrc’r’PD nxrr nt> ct>at>ttc 

0006 

0007 


280 0 
028 0 


EOU 

EQU 

BUFIN(S2800) 

rni 1 T D f 'KPRfn 

BUFFER IN 

1-7-3 0 irnTTTTJ S/. 

0008 



^SET 

miprro rn r»Mr. 



0010 

0011 



it 

STOP SWITCH 



0012 
nm R 

POOOO 

EOOO 

it 

MT 

LQD 


HnliHR 

PDOOl 

P0002 

1281 
A 1 





0015 
nm c. 

P0003 

Dnr)n4 

03FE 

EOOO 


OUT 

LOO 

-1 

= yniiTn4-fFoiiTP-i-? mPEr.T nnr 


P0005 
ponn A 

1282 
CO 0 0 


LDA 


SEL UNIT 1, ASSEMBLY 

nni R 

P0007 

pnnfiR 

04CC 

npOO 


K|OP 


800 bpi, BINARY 

0019 

0020 

P0009 

POOOA 

03FE 
ODF E 


OUT 
I MO 

-1 

-1 


0021 

POOOB 

COOO 


LDA 

=N$80 

WRITE MOTION 


poonc. no ao 


0022 POOOD 0800 


NOP 


; 04 23 POO 0E -- 0 - 3P - E OtWP- 

^ 0024 * 

0025 ik 

0026 * 

0427 POOOF EOOO L-QQ- 

^ POOlO 2280 

, 0 4 >28 POnil CQOO UOA- 

P0012 002C P 

■ — aa2-4-P.ao.i 3 ohoq nqp— 

0030 P0014 03FE OUT 

■ 4031 po ol s O BOO ST.A.T NOP 

- 0032 P0016 02FE INP 

. 0433-80 0 1 .7-0 FCB ALS- 

0034 P0018 0131 SAM 

, 4435 POQl^ IHFB .IMP^ 

0036 POOIA OOUO SLS 

— 4437- P.Q 0.1 B-£44Q LDQ- 

POOIC 1281 

■ 443 8- P .Q 0-lD-Cmu) LDA 

POOIE 0400 

• 443 9 . . PO O-l-fi— 0B40 NOP 

0040 P0020 03FE OUT 

. 411 41 P 0 02 1 CO an loa_ 

P0022 0100 

4H4 2 .P 40 23-QH40 NOP— 

0043 P0024 03FE OUT 

0044 Pfinps podfi I np 

P0026 2A80 

404S P0 n27 c oon LOA 

_P0^28 002C P 

— 000 6 P 002 9- 0 8 00 NOP ■ 

0047 P002A U3FE OUT 

— 40 - 0 8 P002 B 0000 StS— 

0049 P002C 0033 BUF BZS 

— 44E^15 002C P OPO- 

0051 P002C OObF P ADC 

— 40S2 OObF P OPO^ 

0053 END 




HERE IS WHERE NORMALLY WE 


WOULD SEL EOF - INT AND 

OUTPUT IT 

=XBUF06->- E QUIR BUFFER -OUT 


-XBUF FWA - l - 


-1 


-1 INPUT STATUS 

■U WAIT FOR - EOP 

^' + 2 EOP IMPLIES GOOD PARITY 

STAT 

0 CLEAR BUF FROM CONSOLE 

;;X0UTn6tEQai-P-<-l DIRECT-OUT 

=NS400 REWIND TAPE 


-1 

=IMS1 on READ MOTION 


-1 

= XRiirTM-t-FmiTP BIIEEER— m 

=XBUF FWA-1 


-1 

^ 

BUF (51) 1 CONTROL WORD, 

50 DA T A WORDS 

BUF + 51 put LWA+1 in FWA-1 
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13.0 


13.0 INTRODUCTION 

The preceding chapter, Peripheral Programming I, discussed in detail the procedures 
for programming the standard 1700 peripherals. Inefficiency would result if each user 
program were required to contain the coding necessary to drive a peripheral; therefore, 
the operating system contains programs that perform all input/ output operations. 
These programs are referred to as drivers. 

Drivers are divided into three main parts: initiator, continuator and error, 

13. 1 INITIATOR SECTION OF DRIVER 

The initiator portion sets up the logic to be used and initiates the operations to be per- 
formed. The paper tape reader shall be used as an example. All of the drivers are 
written in interrupt mode. Interrupt mode allows the driver to initiate an operation and 
select interrupts, exit to the operating system and regain control when the peripheral 
has completed the operation. 


LDQ 

=N$A1 

SEL PTR, FUNC 

ENA 

1 

CLR CONTROLLER 

OUT 

-1 


ENA 

$34 

START MOTION, SEL INT ON 

OUT 

-1 

ALARM OR DATA 

EXIT TO OPERATING SYSTEM 


Via the above coding, the initiator portion of the paper tape reader has selected the 
equipment, selected interrupts, and exited to wait for an interrupt. The initiator 
portion of every driver initiates these three operations. 

13. 2 INTERRUPT FROM EQUIPMENT 

The equipment will generate an interrupt when a selected interrupt condition arises. 
The acknowledgement of interrupt is on a priority basis. The priority depends on the 
setting of the 16 -bit mask register. A maximum of 16 interrupt lines may be connected 
to the 1700, with each line corresponding to a bit in the mask register. 


15 14 13 12 11 10 9 8 


M 


Line 15 | 

Line 14 

Line 13 

Line 12 

Line 11 

Line 10 

Line 9 

Line 8 


yj 


Line 0 
Line 1 


Line 2 
Line 3 
Line 4 
Line 5 
Line 6 
Line 7 


13-1 




13.2 


The bit in the corresponding bit position must be a 1 in order for the interrupt to be 
acknowledged. If the bit is a 0, the interrupt holds and is not acknowledged until the bit 
becomes a 1. 

Once the bit is set to a 1 in the M register, control is transferred to the interrupt trap 
region. The trap region is set up to allow four words for each interrupt line. The core 
locations are always from location IOO 10 to 13F]I^0. See section 1. 3 to review the in- 
terrupt system. 



LINE 15 


LINE 1 


LINE 0 


Interrupts may be nested 16 deepl 


Four core locations reserved for each 
interrupt line: 


- word 4 - address of interrupt processor 

- word 3 - priority level for line 

- word 2 - RT J to interrupt handler 

- word 1 - overflow and P 


Figure 34. 1700 Interrupt Hardware and Software Fimctions 


Hardware: 

• Disables Interrupts 

• Stores overflow indicator and P of interrupted program in word 1 

• Transfers control to word 2 
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Software: 

• Word 2 contains RTJ to common interrupt handler 

• Interrupt handler saves registers of interrupted program, sets new mask from 
priority level in word 3, enables interrupts, and transfers control to interrupt 
processor for that line (from address in word 4). 

• Interrupt processor must exit to the driver continuator which will service the 
equipment (i. e. , input data). 

• The continuator must exit through the dispatcher to restore the interrupted program. 

The computer hardware disables interrupts and stores the contents of the P register 
in the lower 15 bits of the first trap word for the interrupting line. The hardware sets 
the upper bit of the first word to a 1 if the overflow indicator is on and to a 0 if the 
indicator is off. Control is then passed to the second word. 

Once control is passed to the second word, the processing is under software control. 
See Figure 36 for hardware and software functions. 

13. 3 COMMON INTERRUPT HANDLER 

The second word contains a return jump to the common interrupt handler. The common 
interrupt handler saves the contents of all the pertinent registers: A, Q, M, and I. 
The M register is set to the priority for the interrupting line by using the priority level 
set in the third word. Interrupts are then enabled by the common interrupt handler. 
The interrupt handler transfers control indirectly through the fourth word to the pro- 
cessor for that line. 

13. 4 INTERRUPT LINE PROCESSOR 

The processor for the interrupt line (LYNEI or EPROC) takes status on all equipment 
on the interrupting line and checks bit 2 of each status word. 

The processor will be able to determine which peripheral interrupted because the in- 
terrupt bit (bit 2) of the status word will be set. The interrupt processor will pass 
control to the appropriate continuator portion of a driver. 

13. 5 CONTINUATOR SECTION OF DRIVER 

The continuator checks the alarm bit to determine if control should be passed to the 
error portion of the driver. 
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LDQ 

NOP 

=N$A1 

INP 

-1 

STA 

STATUS 

AND 

=N$20 

SAZ 

1 

JMP 

ERR 


SEL PTR, STATUS 

STATUS IN A 
SAVE STATUS 
CK FOR ALARM 
IF ZERO CONTINUE 
IF NOT ZERO ALARM 


If the alarm bit were not set the interrupting condition would be processed by the con- 
tinuator. The continuator checks further to determine which interrupt was generated. 
The paper tape reader allows the selection of only two interrupts, alarm and data; 
therefore, if the alarm bit was not set the data interrupt was probably generated. It 
would be wise to check the data interrupt bit and if it is not set, pass control to GI 
(ghost interrupt) in the error section; 

LDA STATUS 

AND =N8 

SAN DATA 

JMP GI 

Input data if the data bit was set: 


DATA LDQ =N$AO SEL PTR, DATA 

NOP 

INP -1 DATA IN A 

The continuator then performs the necessary packing operations to form one 16-bit 
word. A check is made to determine if all data has been processed. If not, the con- 
tinuator exits to wait for the next interrupt. 

LDQ =N$A1 SEL PTR, FUNG 

ENA $14 INT ON DATA OR ALARM 

OUT -1 

EXIT TO OPERATING SYSTEM 


The continuator could simply exit without reselecting interrupts because the interrupt 
request is still up if it has not been cleared. 

13. 6 ERROR SECTION OF DRIVER 

The ERROR portion takes status to determine which alarm condition has arisen. Thel 
error routine then performs the necessary operation to correct the error. If the error 
cannot be corrected without operator intervention, the operator should be notified. 
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LDQ 

NOP 

=N$A1 

SEL PTR, STATUS 

INP 

-1 

STATUS IN A 

ALS 

5 

POWER ON BIT AT 15 

SAM 

POWOFF 


ALS 

1 

PAPER MOTION FAIL BIT AT 15 

SAP 

PMF 


ALS 

3 

LOST DATA BIT AT 15 

SAM 

LOSTD 


JMP 

GI 

IF HERE NO ALARM OCCURRED 


The above coding establishes the condition at fault. The skip address sends control to 
routines that process the various errors, 

GI is where control is passed for a ghost interrupt. The equipment interrupted but ap- 
parently for no reason. This would indicate a hardware malfunction. 

13.7 SUMMARY 

The driver can be summarized as follows. The initiator is the first to have control. It 
selects the equipment and selects interrupts, then it exits to the operating system. 
The continuator gains control via the interrupt trap area after the peripheral generates 
an interrupt. It checks for alarm and if one is present, sends control to the error 
portion. If no error occurred, it maintains control and processes the interrupt. If the 
operation is not complete the continuator exits to the operating system. The error por- 
tion determines which alarm condition occurred and attempts to correct the fault and/or 
notifies the operator. Figure 35 illustrates the flow of the interrupts through the con- 
tinuator. 

It is important to note that the primary purpose of this chapter is to illustrate tech- 
niques for programming the hardware in interrupt mode. The linkage through MSOS 
routines is secondary. 

The logical division of programming functions into initiator, continuator, and error 
sections could be utilized to program any peripheral, either in a stand-alone system or 
under MSOS. The operations to be included in each section are the important consid- 
eration here — what the equipment is capable of doing, its timing, and the status of 
responses it can send. At this point the programmer should be able to write an in- 
terrupt-mode driver which would not run under MSOS. 

To actually write a driver to run under MSOS, it would be necessary to study all the 
linkage to MSOS since system tables and common subroutines are used by all the MSOS 
drivers. 

Some of the MSOS routines are included at the end of this chapter for illustration. 
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Example 

The following is a test program to print a message on the teletype in interrupt mode. It 
uses the MSOS Interrupt Handler to save the state of the interrupted program (probably 
the idle loop) each time the interrupt comes in. It bypas s e s the Line 1 Interrupt Pro- 
cessor (interrupt response routine) and MSOS driver by storing its own address in the 
fourth word of the interrupt trap for Line 1 (location $107). 

After the program has been assembled and loaded under MSOS, the computer should be 
stopped, the protect switch turned off, and P set to the address TTYI; then it should be 
run. A master clear should not be done because that would disable the interrupt system 
and clear M. 

In reality, if a program such as this were used in a stand alone system, it would assure 
that bit 1 was set in the M register and execute an EIN. It would also have a routine cor- 
responding to the interrupt handler to save the state of an interrupted program. 

The test routine here simulates the operations on the equipment which would logically be 
performed by different portions of a driver. 

1. TTYI sets up the trap. 

2. INIT is the initiator to set up the equipment. It then exits and waits for the first in- 
terrupt, 

3. CONT is the continuator and it outputs a character each time the interrupt comes in. 
It also must keep track of the number of words desired to be written. It hangs at 
CMPLET when finished. An MSOS driver would schedule the programmer’s com- 
pletion address when his request was finished. 

4. ERR. The error section analyzes errors. It hangs in the test r ou tine on each 
error, but in MSOS it would attempt to correct the error. 

5. The TABLES used by the routine contain information which is used by the driver for 
the write; they simulate a physical device table. 

6. INTRES. The interrupt response routine is actually not a part of the driver. It must 
status each device on the line to see which one interrupted. Our example only checks 
the TTY. 
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r' • 


u 

0001 




NAM 

TTY INTERRUPT MODE 


0002 



LOAU 

THE PROGPAM 

UNDER MSOS 

- TURN OFF PROTECT SWITCH 


0003 



* TUHN 

OFF DISC - 

DO NOT MASTER CLEAR - SET P AND RUN 


00 0 ^ 


uOla 


EOU 

ADISP (SEA) 



0005 




ENT 

TTYHC0NT3 

£RR» INTRES 


0006 

POOOU 

00 0 0 

TTY 1 

0 

0 



0007 

PUOO 1 

COOO 


LOA 

=XINTRES 

SUBSTITUET INTRES IN TRAP 



P0002 

003A P 






0008 

P0003 

6400 


STA + 

S107 




POO 04 

0107 






0009 



if 





0010 






INITIATOR 


0011 

P0005 

EB30 

INIT 

LDQ^- 

TTY 

GET TTY FUNC CODE 


0012 

P0 006 

0a03 


ENA 

3 

CLR CONTROL CLR INTERRUPT 


0013 

P0007 

0 3F E 


OUT 

-1 



"0014 

POO 08 

COOO 


LOA 

=N$100 

SELECT WRITE MODE 



P0 009 

OlOO 






0015 

POOOA 

ObOO 


NOP 




0016 

POOOb 

0 3FE 


OUT 

-1 



0(317 

POOOC 

ODFE 


INQ 

-1 

change to DATA FUNCTION 


0018 

POOOD 

OBOO 


NOP 




0019 ‘ 

■ P 0 0 0 E 

03FE 


OUT 

-i 

OUTPUT DUMMY CHARACTER 


0020 

POOOF 

OUOl 


INQ 

1 

SEND FUNCTION 


0021 

POO 10 

0 A 1 4 


ENA 

S14 

SEL interrupt alarm or DATi 


0022 

POOH 

0 3FE 


OUT 

-1 


o 

0023 

0024 

POO 12 

14EA 


JMP- 

(ADISP) 

GO WAIT FOR INT 

0025 

, . . . 





CONTINUATOR 

0026 

POOH 

C825 

CONT 

LDA^ 

STAT 

GET STATUS BACK 


0027 

POOH 

01- CA 


ALS 

10 

CK ALARM BIT 5 


0028 

POO 15 

0121 


SAP 

OK-*-l 



0 0 29 

POO 16 

1817 


JMP^ 

ERR 

ALARM UP 


0030 

POOH 

0FC2 

OK 

ALS 

2 

CK DATA BIT 3 


"0 031 

P0018 

0131 


SAM 

DATA 



0032 

POOH 

182 7 


JMP^ 

GI 

NOT ALARM OR DATA 


0033 

pool A 

CCOO 

DATA 

LDA 

(FWA) 

GET DATA 



POOIB 

0018 






0034 

POOIC 

E81D 


LDQ^ 

FLAG 

GET CHAR FLAG 


0035 

POOID 

0144 


SQZ 

LOWER 



• 0D36' 

■POOIE 

0FC8 


ALS 

8 

UPPER CHAR 


0037 

POO IF 

OCOO 


enq 

0 



0038 

P0020 

4819 


STQ^ 

FLAG 

CLR FLAG FOR LOWER NEXT 


0039 

P0021 

1803 


JMP^ 

OUTPUT 

GO OUTPUT DATA 


0040 

P0022 

□ 81 7 

LOWER 

RAO^ 

FLAG 

SET FLAG FOR UPPER NEXT 


0041 

P0023 

□ 813 


RAO* 

FWA 

UPDATE BUFFER ADDR 


*00'42 

P0024 

E811 

OUTPUT 

LDQ* 

TTY 



0043 

P0025 

ODI- E 


INQ 

-1 

DATA FUNC 


0044 

P002O 

OBOO 


NOP 




0045 

P0027 

0 3r E 


OUT 

-1 

OUTPUT 1 CHAR 


0046 

P0028 

C60E 


LDA* 

FWA 

LAST WORD YET 


0 04 7 

P0029 

880E 


EOR* 

LWA 



-'OOAB 

P002A 

0101 


SAZ 

CMPLET 



0049 

P002b 

IAEA 


JMP- 

(ADISP) 

GO AWAIT NEXT INT 


0050 

P002C 

18FF 

cmplet 

NUM 

S18FF 

HANG WHEN FINISHED 

o 

0051 
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0052 






ERPOP SECTION 

0053 






FIND CAUSE OF ERROR 

0054 

P002D 

C80B 

EPP 

LDA^- 

STAF 


0055 

P002E 

UP’Cb 


ALS 

5 

CK MOTOR ONN 

0056 

P0 0 2F 

0131 


SAM 

1 


0057 

P0030 

l8h F 


NUM 

518FF 

MOTOR OF'F - HANG HERE 

0058 

P0031 

OF C4 


ALS 

4 

CK LOST DATA 

0059 

P0032 

0121 


SAP 

1 


0060 

P0033 

18FF 


NUM 

518FF 

LOST DATA - HANG HERE 

0 061 

P0034 

180C 


JMP^ 

61 

NO ERROR APPARENT... 

0062 



a- 




0063 






TABLES (PHYSTB) 

0064 






USED BY DRIVER 

0065 

P0035 

0091 

TTY 

NUM 

591 

TTY FUNC CODE 

0066 

P0036 

0041 p 

FWA 

AUC 

BUF 

CURRENT BUFFER ADDRESS 

0067 

P0037 

0064 p 

LWA 

ADC 

BUF+35 

LWA + 1 

0068 

P0038 

0001 

STA7 

BZS 

STATU ) 

STATUS WORD 

0069 

P0039 

0001 


BZS 

FLA6U ) 


0070 







00 71 






INTERRUPT RESPONSE 

0072 






NO! PART OF DRIVER 

0073 

P003A 

E8FA 

INTHES 

LDQ« 

TTY 


0074 

P003B 

02FE 


INP 

-1 

STATUS TTY 

“HOTS” 

■pooic 

b8F B 


STA^^ 

STAT 

SAVE IT 

0076 

P003U 

OFCD 


ALS 

13 

CK INTERRUPT BIT 

0077 

P003E 

0121 


SAP 

GI-i^-1 


0078 

P003F 

18U3 


JMP<^ 

CONT 

GO TO TTY CONTINUATOR 

“1T079 

PF04cT' 

iaFF' 

G1 

NUM 

S18FF 

GHOST INTERRUPT HANG HERE 

0080 







0081 

P0041 

2054 

BUF 

ALF 

35, THIS 

MESSAGE IS WRITTEN IN INTERRUPT 


pool'd 46^9 
'P0 043 53<:^0 
P0044 4D‘+b 

—f5TF(r4b'"'5333 ' 
P0046 4147 
PO 047 4530 
P0048 4953 
“ P0049 2057 
P004A 5249 
■'“PT04B~3454 ’ 
P004C 454E 

■ P004D 2049 
P004E 4E2U 
P004F 494E 
P005U 5445 

■ PtJOSl 5252 

P0052 5550 
P0053 5420 
P0054 404F 
PD 055 4445 
P005b 2020 

”"PDOSr 2020 

P0058 2020 
P0059 2020 
P005A 2020 
P005B 2020 
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P005C ^020 
P005D 2020 
P005E 2020 
P005F' 2020 
P0060 2020 
P0061 2020 
P0062 2020 
POO 63 2020 
0082 * 
0083 


I OOFF ADISP OOEA 

INTRES 003AP INIT 0005P 

OUTPUT 002^P CMPLET 002CP 

STAT 0038P FLAG 0039P 


o 


END 


TTYI 

OOOOP 

CONT 

0013P 

ERR 

OK 

0017P 

DATA 

OOIAP 

LOWER 

TTY 

0035P 

FWA 

0036P 

LWA 

GI 

OO^OP 

BUF 

0 0 A IP 



J 


*p 

J 

*ASSEM 
OPTIONS LX 


J 


*p 


J 

*L,8 

J 

THIS MESSAGE IS WRITTEN IN INTERRUPT MODE 


002DP 

0022P 

0037P 


o 
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Figure 35. Interrupt Flow 
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13. 8 The following is an example of one of the ADSD bulletins, illustrating interrupt pro 
cessing routines. 
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CONTROL DATA; 

C O K i' < ) 1-^ A I I (J N 


Number: 4 
December, 1967 


INTERRUPT PROCESSING ROUTINES 

This Information Bulletin briefly describes the software involved in processing an interrupt. 
Although interrupt processing is not new, it is often misunderstood. An Interrupt Service 
Routine varies in complexity depending on the hardware constraints and user requirements. 

The Interrupt Service Routine used in the CONTROL DATA 1700 Computer Operating System 
is not a "closed" routine; rather, it is a group of subroutines which are linked together to 
provide the flexibility required by today's state-of-the-art programming techniques. 

The following conditions must be met in the CDC 1700 Computer before an interrupt can be 
detected. 

9 The interrupt system must be enabled. 

0 An interrupt line must be true. 

0 The corresponding bit in the interrupt Mask register (M) must be set. 

In the following discussion, it has been assumed that the above conditions have been met and 
that the interrupt is detected or trapped. When an interrupt is trapped, the program sequence 
is interrupted (or suspended), the address of the instruction to have been executed next is 
saved, the interrupt system is disabled, and control is transferred to the Interrupt Trap Region. 

INTERRUPT TRAP REGION 

The Interrupt Trap Region is a dedicated area of memory from location IOO 10 through location 
13 F 20 (64 locations). Four consecutive locations in this region are assigned to each interrupt 
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line. Since there are 16 interrupt lines with 4 memory cells for each line, there are 64 loca- 
tions assigned to the Interrupt Trap Region. The first four locations are for interraipt line 
"0, ” the next four are for interrupt line " 1 , ” and so on. When an interrupt is trapped, control 
is transferred to the second location of the group that is associated with the interrupt line. The 
exact location is computed as 

LOG. lOOie + ^16 (LINE NO.) + 1. 

The four memory locations for each interrupt line are shown below followed by an explanation 
of the contents of each word. (Words are labeled A, B, C, and D.) 


INTERRUPT ADDRESS 

LINE NO. BASE 16 



A 


When an interrupt is trapped, the address of the instruction to have been executed next 
is saved in A 14 - Aq. A 15 will contain the Overflow flip-flop's status when the interrupt 


was trapped. Loading this memory location as described above is accomplished automa- 
tically by the hardware. 
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B = This location normally contains a one -word indirect Return Jump instruction to a routine 
that is responsible for preserving the state of the computer’s registers (A, Q, I), con- 
tents of location "A" and the interrupted programs priority level. In most cases, this 
Return Jump is to the Common Interrupt Handler. The exact parameters for this word 
are decided when building the Operating System. 

C = This location contains the software priority level associated with this interrupt line. 

Note that only one priority level can be associated with a given interrupt line; however, 
any number of interrupt lines, up to 16, can be assigned the same software priority 
level. The exact parameters for this word are decided when building the Operating 
System. (See Note 2.) 

D = This last location of the four-word group contains the absolute address of the Interrupt 
Response Routine for this interrupt line. 

From the above descriptions it can be seen that the "A" parameter is loaded automatically by 
the hardware and that control is transferred to the "B" parameter (Return Jump). It is assumed 
in this discussion that the Return Jump instruction passes control to the Common Interrupt 
Handler. See Note 1. 

COMMON INTERRUPT HANDLER 

The Common Interrupt Handler saves the state of the computer (interrupted program) in the 
Interrupt Stack Region. Information saved includes the contents of the A-, Q-, I-, and P- 
registers, the Overflow status, and the software priority of the interrupted program. The 
Common Interrupt Handler then sets the new software priority level, sets the M-register for 
the new software priority level, enables the interrupt system, and transfers control to the 
address specified by the "D" parameter, the absolute address of the Interrupt Response 
Routine. 

INTERRUPT RESPONSE ROUTINE 

The Interrupt Response Routine is usually a small, user-written subroutine to determine which 
device caused the interrupt if there is more than one device on the interrupt line and transfer 
control to the "driver" entry point to process the interrupt. 

DRIVERS 

The Driver acknowledges (clears) the interrupt line and processes the data as required. Even- 
tually, upon completion of the program initiated by the interrupt, the Driver passes control to a 
module which is responsible for returning the computer to the original state of the secured pro- 
gram. In the CDC 1700 Computer Monitor, this module is called the Dispatcher. 

DISPATCHER 

The Dispatcher returns the computer to its original state (its condition at the time of the 
interrupt) by reloading the A-, Q-, I-, and P-registers, Overflow Status, and priority 
levels from the Interrupt Stack Region and transfers control back to the address stored as 
parameter "A" in the Interrupt Trap Region. The M-register is also restored. 
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FROM INTERRUPTED 


PROGRAM 



SPECIAL NOTES 



Note 1 


A software rule exists which states that interrupts will not be inhibited for more than 45 mem- 
ory cycles (50 /zs). If an interrupt can be processed in less than 50 /xs, the Common Interrupt 

Handler and the Dispatcher may be bypassed. Therefore, in such cases, parameters ”C" and 

"D" in the Interrupt Trap Region will not be necessary. The one-word indirect Return Jump 

in location B will transfer control directly to the Interrupt Response Routine or Driver. 

Note 2 

Interrupt priorities 

1. Hardware priorities are from the lower numbered interrupt lines, to the hi^er numbered 
interrupt lines. The lower numbered lines being recognized first by the hardware. 

2. Software priorities are not necessarily associated with interrupt line numbers, the higher 
software priority numbers are processed first. For example, a program running at soft- 
ware priority level 5, requests a driver that has a software priority level of 10. The 
running program would be interrupted and the driver would be initiated (software interinpt) . 

As an example of how the hardware and software priorities work together assume tlie following: 

1. Processing is being accomplished by the Monitor with interrupts disabled. 

2. When the interrupt system is enabled there are two hardware interrupts ready for 
processing interrupt line-1 (common synchronizer), and software priority level 10, and 
interrupt line-2 (the timer) software priority level 13. 



When the interrupt system is enabled the hardware control will trap the interrupt from line-1 
(higher priority, lower line number and disable the interrupt system) . This interrupt will be 
processed through the Common Interrupt Handler requiring about 50 microseconds. The Com- 
mon Interrupt Handler sets the new software priority level (M -Register Mask), enables interrupts, 
and transfers control to the Interrupt Response Routine. Interrupt line-2 will trap. This is 
allowed by the mask setting in the "M” register. The software priority of the "Timer” is always 
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higher than the common synchronizer and must be processed first. However, this could not 
have been determined prior to the interrupt response routine. Line-2 will continue being 
processed until completion or until it itself is interrupted. 

Therefore, even though the hardware indicated that interrupt line-1 had priority, the software 
dictated that interrupt line -2 actually had a higher priority. 


^ r 


f V- 


Del Sandusky // 
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13. 9 The following is a listing of the interrupt handler, 


001. 




NAM 

COMMON INTERRUPT HANDLER 

003. 


* 


PART NO. E00610A0010S 


005. 




ENT 

ALLIN 


006. 

00B8 



EQU 

COUNT ($B8) 


007. 

OOEF 



EQU 

PRLVL($EF) 


008. 

00B7 



EQU 

AMASKT($B7) 


009. 

0022 



EQU 

ZERO($22) 


010. 


* 





on. 


* 


AFTER CONTROL IS TRANSFERRED FROM THE INTERRUPT 

012. 


* 


TRAP LOCATION TO THE COMMON INTERRUPT HANDLER, 

013. 


* 


THE RETURN LOCATION, A, 

Q AND I REGISTERS AND 

014. 


* 


PRIORITY ARE SAVED IN A PUSH-UP POP-DOWN STACK 

015. 


* 


BY PRIORITY LEVEL. THEN THE NEW PRIORITY AND 

016. 


* 


MASK ARE SET AND CONTROL IS TRANSFERRED TO THE 

017. 


* 


ADDRESS ASSOCIATED WITH THE LINE ON WHICH THE 

018. 


* 


INTERRUPT APPEARED. 


019. 


♦ 





020. 

0000 



EQU 

XQ(0),XA, (1),XI(2),XR(3),XPL(4),XL(5) 


0001 







0002 







0003 







0004 







0005 






021. 

POOOO 0000 

ALLIN 

0 

0 

LINK TO LEVEL ENTRY 

022. 

POOOl 44BB 



STQ- 

(COUNT) 

SAVE Q IN STACK 

023. 

P0002 E0B8 



LDQ- 

COUNT 

STACK COUNTER AS INDEX 

024. 

P0003 6201 



STA- 

XA,Q 

SAVE A 

025. 

P0004 COEF 



LDA- 

PRLVL 

SAVE PRIORITY 

026. 

P0005 6204 



STA- 

XPL,Q 


027. 

POOOO COFF 



LDA- 

I 

SAVE MEMORY 

028. 

P0007 6202 



STA- 

XI, Q 

INDEX REGISTER 

029. 

P0008 40FF 



STQ- 

I 

STACK LOCATION BASE 

030. 

P0009 0D05 



INQ 

XL 

UPDATE STACK 

031. 

POOOA 40B8 



STQ- 

COUNT 


032. 

POOOB E8F4 



LDQ* 

ALLIN 

LEVEL LINK 

033. 

POOOC ODFD 



INQ 

-2 

ADJUST TRAP LOCATION 

034. 

POOOD C622 



LDA- 

(ZERO),Q 

RETURN LOCATION 

035. 

POOOE 6103 



STA- 

XR,I 


036. 

POOOF 40FF 



STQ- 

I 

SAVE TRAP LOCATION IN I 

037. 

POOlO E202 



LDQ- 

2,Q 

SET NEW 

038. 

POOH 40EF 



STQ- 

PRLVL 

PRIORITY LEVEL 

039. 

P0012 C6B7 



LDA- 

(AMASKT),Q 

SET NEW MASK I M REGISTER 

040. 

P0013 0400 



EIN 



041. 

POOH 0821 



TRA 

M 


042. 

P0015 El03 



LDQ- 

3,1 

JUMP TO PROCESSOR 

043. 

P0016 1622 



JMP- 

(ZERO),Q 

LOCATION IN Q 

044. 




END 



I 

OOFF ALLIN 

OOOOP 

COUNT OOBB PRLVL 

OOEF AMASKT 00B7 

ZERO 

0022 XQ 


0000 

XA 

0001 XI 

0002 XR 0003 

XPL 

0004 XL 


0005 





13-16 



13. 10 


13. 10 The following is a listing of the dispatcher 


001. 




NAM 

DISPATCHER 

003. 



* 

PART NO. E00610A0020S 

005. 




ENT 

DISP, SCHTOP 

006. 




EXT 

SCHSTK, SCHLNG 

007. 


00B8 


EQU 

CONT($B8) 

008. 


OOEF 


EQU 

PRLVL($EF) 

009. 


00B7 


EQU 

AMASKT($B7) 

010. 


0104 


EQU 

COMEXT($104) 

on. 


0002 


EQU 

LPMSK($2), NZERO($12), ZERO($22), ONEBIT($23), ZROBIT($33) 



0012 






0022 






0023 






0033 




012. 


0009 


EQU 

RCSCHD{9) 

013. 


0000 


EQU 

XQ(0), XA(1) , XI(2), XR(3), XPL(4), XL(5) 



0001 






0002 






0003 






0004 






0005 




014. 


00B4 


EQU 

TOMPT($B4) 

015. 


0001 


EQU 

PC(1),PT(2),PQ(3) 



0002 






0003 




016. 



* 

UPON COMPLETION OF A PROGRAM, THE DISPATCHER 

017. 



* 

DETERMINES THE PROGRAM OF HIGHEST PRIORITY 

018. 



* 


WAITING FOR EXECUTION. IT MAY EITHER BE IN THE 

019. 





INTERRUPT STACK OR THE SCHEDULER STACK. 

020. 



* 



021. 



* 



022. 

POOOO 

FFFF 

SCHTOP 

NUM 

$FFFF SCHEDULE STACK TOP 

023. 

POOOl 

E0B8 

DISP 

LDQ- 

CONT 

024. 

P0002 

ODFA 


INQ 

-XL ADJUST STACK 

025. 

P0003 

0500 


IIN 

0 

026. 

P0004 

C8FB 


LDA* 

SCHTOP IF SCHEDLER STACK IS 

027. 

P0005 

0900 


INA 

0 

028. 

P0006 

0106 


SAZ 

RESINT-*-! EMPTY, CHECK INT. STACK 

029. 

P0007 

CCF8 


LDA* 

(SCHTOP) LOAD FIRST WORD 

030. 

P0008 

A006 


AND- 

LPMSK+4 ISOLATE PRIORITY 

031. 

P0009 

0821 


TRA 

M SAVE TEMP. IN M 

032. 

POOOA 

9204 


SUB- 

XPL,Q PRIORITY OF HIGHEST INT. 

033. 

POOOB 

0101 


SAZ 

RESINT-*-! GO TO INTERRUPT STACK 

034. 

POOOC 

012C 


SAP 

SCHSTC-*-! GO TO SCHEDLE STACK 

035. 



* 



036. 



* fflGHEST PROGRAM IS IN THE INTERRUPT STACK. 

037. 



* 



038. 

POOOD 

C203 

RESINT 

LDA- 

XR,Q SET RETRN LOCATION 

039. 

POOOE 

6C2B 


STA* 

(ACOMEX) 

040. 

POOOF 

C202 


LDA- 

XI, Q RESTORE I 

041. 

POOlO 

60FF 


STA- 

I 

042. 

POOH 

C201 


LDA- 

XA, Q RESTORE A 

043. 

P0012 

40B8 


STQ- 

CONT STORE INT. STACK BASE 

044. 

P0013 

E204 


LDQ- 

XPL,Q RESTORE PRIORITY LEVEL 

045. 

P0014 

40EF 
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046. 

047. 

P0015 

P0016 

E6B7 

0811 


LDQ- 

TRQ 

(AMASKT),Q 

M 

RESTORE MASK 

048. 

049. 

050. 

P0017 

P0018 

E4B8 

0E04 

* 

LDQ- 

EXI 

(CONT) 

COMEXT-256 

RESTORE Q 


051. 



* fflGHEST PROGRAM IS IN THE SCHEDLER THREAD. 

052. 



* 




053. 

P0019 

080A 

SCHSTC 

TRM 

Q 

PRIORITY TO Q 

054. 

POOIA 

40EF 


STQ- 

PRLVL 

SET NEW PRIORITY AND MASK 

055. 

POOIB 

C6B7 


LDA- 

(AMASKT),Q 


056. 

POOIC 

0821 


TRA 

M 


057. 

POOID 

E8E2 


LDQ* 

SCHTOP 

STORE NEW POINTER 

058. 

POOIE 

C202 


LDA- 

PT,Q 

TOP OF SCHEDLER THREAD 

059. 

POOIF 

68E0 


STA* 

SCHTOP 


060. 

P0020 

0814 


TRQ 

A 

TEST IF PRIMARY SCHEDULER 

061. 

P0021 

9819 


SUB* 

ASCHD 

CALL WAS MADE. 

062. 

P0022 

0138 


SAM 

SCHSEC-*-! 


063. 

P0023 

9818 


SUB* 

ASCLNG 


064. 

P0024 

0126 


SAP 

SCHSEC-*-! 


065. 

P0025 

C0B4 


LDA- 

TOMPT 

IF PRIMARY CALL RELEASE 

066. 

P0026 

6202 


STA- 

PT,Q 

STACK POSITION AND PLACE 

067. 

P0027 

40B4 


STQ- 

TOMPT 

ON EMPTY THREAD. 

068. 

P0028 

C201 


LDA- 

PC,Q 

LOAD ABSOLUTE ADDRESS 

069. 

P0029 

6C10 


STA* 

(ACOMEX) 

STORE INTO COMEXT 

070. 

P002A 

180C 


JMP* 

SCHXIT 


071. 

P002B 

C622 

SCHSEC 

LDA- 

(ZERO),Q 

TEST IF ABSOLTE OR RELATIVE 

072. 

P002C 

A02B 


AND- 

ONEBlT+8 


073. 

P002D 

0101 


SAZ 

SCHl-*-l 

CALL. SKIP IF ABSOLUTE 

074. 

P002E 

0814 


TRQ 

A 

ADDRESS 1ST WD OF CALL 

075. 

P002F 

AOll 

SCHl 

. AND- 

LPMASK+15 


076. 

P0030 

8032 


ADD- 

ONEBlT+15 


077. 

P0031 

8201 


ADD- 

PC,Q 

ADD REL. ADDRESS OR IF 

078. 

P0032 

AOll 


AND- 

LPMSK+15 


079. 

P0033 

6C06 


STA* 

(ACOMEX) 

A=0, ABS ADDRESS AND STORE 

080. 

P0034 

0844 


CLR 

A 

ZERO INTO THREAD 

081. 

P0035 

6202 


STA- 

PT,Q 

COMPLETION INDICATION 

082. 

P0036 

0814 

SCHXIT 

TRQ 

A 

PASS POINTER TO CALL IN A 

083. 

P0037 

E203 


LDQ- 

PQ, Q 

PASS, Q 

084. 

P0038 

0E04 


EXI 

COMEXT-256 


085. 

P0039 

0104 

ACOMEX 

ADC 

COMEXT 


086. 

P003A 

7FFF X 

ASCHD 

ADC 

SCHSTK 

SCHED. STACK LOCATION 

087. 

P003B 

7FFF X 

ASCLNG 

ADC 

SCHLNG 

SCHED. STACK LENGTH LOC. 

088. 




END 




I 

OOFF 

DISP 

OOOIP 

SCHTOP 

OOOOP 

CONT 

00B8 

PRLVL 

OOEF 

AMASKT 

00B7 

COMEXT 

0104 

LPMSK 

0002 

NZERO 

0012 

ZERO 

0022 

ONE BIT 

0023 

ZROBIT 

0033 

RCSCHD 

0009 

XQ 

0000 

XA 

0001 

XI 

0002 

XR 

0003 

XPL 

0004 

XL 

0005 

TOMPT 

00B4 


0001 

PT 

0002 

PQ 

0003 

RESINT 

OOODP 

SCHSTC 

0019P 

SCHSEC 

002BP 

SCHl 

002FP 

SCHXIT 

0036P 

ACOMEX 

0039P 

ASCHD 

003AP 

ASCLNG 

003BP 

SCHLNG 

003BX 

SCHSTK 

003AX 
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14.0 


14.0 INTRODUCTION 

The MSOS library editing program, LIBEDT, can be used effectively for adding routines 
to the program library, exchanging old routines in the program or system library for 
new ones, and for many utility functions such as transferring records from one logical 
imit to another, absolutizing programs, etc. 

The LIBEDT chapter of the MSOS reference manual describes the features of LIBEDT 
very accurately. Therefore, this chapter will consist simply of examples using 
LIBEDT. 

14. 1 MASS MEMORY REPLACE 

The first example, teletype printout, shows a sample of the checking which could be 
done while replacing a mass memory module in the system library. The replacement 
module is larger than the original one. The comments on the listing are self-explana- 
tory. 
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LIBEDT MASS MEMORY REPLACE 



♦LIBEDT 

LIB 


IN 


♦DL 

IN 

Dump program library 

♦DM 

IN 

Dump system library 


*M,20, ,Mii Cancel this statement with rub-out, LF, CR 

*K, 12 ^ Input on lun 2 PTR 

IN 


Replace MM ordinal #26 in system library 


Add and link subroutines from PTR 

ACTION 

RP 

L,02, FAILED 02 

ACTION 

CU 


*M,26,,M 

L,02 FAILED 02 

ACTION 

RP 

L,02 FAILED 02 > 


E *E 
MI 
*Z 
J 

*p 

J 

♦LIBEDT 

LIB 

IN 

♦DM 

IN 


♦Z 

J 

♦P 

J 

♦L,8 

J 

♦SR > 

J 

*X,, 

RE 

♦M2E6 

RE 

♦M2E6,'0, 2F1 y 
RE 

♦M2F1,0,2F5 

RE 

♦DCO, Cl ^ 

RE 


Patch missing externals from core resident entry points 


Following checking is only to illustrate debugging features: 


Check to see if ordinal changed (sector address should be larger because new 
program is larger than one it replaces; therefore, it will be put in first avail- 
able scratch sector) 


Dummy L and X to get sys. rec. package 


Dump sector $2E6 (on LP) to check program 


Dump core $C0 and $C1 - scr sector address 


r 
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/" \ 14. 2 GTFILE REQUEST FOR SYSTEM INITIALIZER 


This example is not actually a LIBEDT example. However, it is included because it 
pertains to the system initializer. GETSI is a program which can be modified to be 
included in any program library (in relocatable binary form); it can then be called into 
execution in the background by: 



The program does a GTFILE request to bring in a file, SYSINI, from the program 
library to address $6000. SYSINI is actually an absolute copy of the system initializer. 
GETSI then jumps to $6000 to execute the system initializer. This is very handy be- 
cause it provides for storing the system initializer on the program library so it can be 
called in without having to key in a bootstrap loader from the console. 


O 
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0001 

0002 


0003 

POOOO 

5359 


POO 01 

5349 


POO 02 

4E49 

0004 

P0003 

5349 


P0004 

2049 


P0005 

4E20 

0005 


6000 

0006 

POOOO 

0000 

0007 



0007 

P0007 

54F4 

0007 

P0008 

lAOl 

0007 

P0009 

0014 P 


POOOA 

0000 

0007 

POOOB 

08C2 


POOOC 

0000 


POOOD 

6000 

0007 

POOOE 

0000 


POOOF 

8000 P 

0008 



0008 

POOlO 

54F4 

0008 

POOll 

OAOO 

0009 



0009 

P0012 

54F4 

0009 

P0013 

OAOO 

0010 

P0014 

017B 

0011 



0011 

P0015 

54 F4 

0011 

POOlO 

OCOl 

0011 

P0017 

OOIE P 


P0018 

0000 

0011 

P0019 

18FC 

0011 

POOIA 

0003 


POOIB 

0003 P 

0012 



0012 

POOIC 

54F4 

0012 

POOID 

OAOO 

0013 

POOIE 

0171 

0014 

POOIF 

ICED 

0015 



0015 

P0020 

54F4 

0015 

P0021 

OAOO 

0016 





NAM 

GETSI 



ENT 

SI 


FILNAM 

ALF 

*, SYSINI* 

— Name of FILE in program library 

BUF 

ALF 

*, SI IN* 

— MSG Buffer for TTY 

SIADDR 

EQU 

SIADDR($6000) 

File to go at $6000 

SI 

0 

0 


GETFIL 

GTFILE 

GOT, (FILNAM), SIADDR, , , 0, 0.1 


/ 


Completion address 
after SYSINI is brought 
into core 


\ \ 

' \ \ \ ^RP=0 

dress \ \ \ ^ ^ 


Address 
where 
file name 
is 


EXIT (wait for completion) 
EXIT (unnecessary) 



= 1 
0 

X bit = 0 (not blank) 


Disk address 
left blank; 
program li- 
brary will be 
searched 


GOT 

SUN 


WROTE 

NOGOOD 


SQM NOGOOD 

FWRITE $FC,WROTE,BUF,3,A,0,1,I,0 

LUN 

(std comment COMPL 

device) ADDR 


OTE,BUF,3,A,0, 1,1,0 

I ^ ^ ^ ^ ^ ^ ^ ^ ‘ I X bit = 0 (not blank) 
Indirect bit referring 


to $FC 


CP= 1 
MSG I RP = 0 
BUF ASCII 
3 words 


EXIT 

Wait until Write is done 


SQM 

JMP* 

EXIT 


NOGOOD 

(GETFIL+6) 


Jump to beginning address of 
SYSINI which is $6000 


END 


SI 


This program may be reassembled for any system. Change EQU for the desired high 
core address where the system initializer should run when in core. The system initial- 
izer should be stored in the program library under the file name SYSINI, as an absolute 
file. 
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14. 3 ADDING PROGRAMS AND FILES TO THE PROGRAM LIBRARY 

The following example shows the use of LIBEDT to absolutize the system initializer and 
put it in the program library under file name SYSINI. Then GETSI is put in the program 
library as a relocatable binary program. 

A subsequent system initialization rim was made to check out GETSI; the listing shows 
it beginning to execute. 
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Put System Initializer in Program Library 
MI 

♦p 

J 

♦LIBEDT -m Call in LIBEDT 

LIB 

IN 

Input on lun 2 PTR - sys. ini, in rel. bin. form 

*K, I2,~t*8 -m Absolutize on lun 8 (disk scratch) 

IN 


•te4- 

IN 

*P, F 

L,16 FAILED 01 

ACTION 

RP 

L,02 FAILED 02 

ACTION 

CU 


Absolutize in 96-word blocks for disk 
Printer failed 


Out of tape. Complete absolutizing 


^ E * ♦ 

IN 

*K, 18 
IN 

-*N- 

-tNt 

IN 

*N, SYSINI, , , B 
IN 


I 


*K,I2 

IN 


♦L.GETSI 

L08 

IN 




Unpatched externals (unnecessary modules were taken out of sys. ini. ) - ignore 
Input now on 8 


File SYSINI, binary, placed in pgm. lib. 
Input now on lun 2 PTR (GETSI) 

Put GETSI in pgm. lib. in rel. bin. form 


Sign off LIBEDT 

CHECK IT OUT 

Turn off protect switch here! 
Call in GETSI 


SI IN 

GETSI gets SYSINI and types SI IN 

SI ^ 

System initializer types SI 

*1,1 ^ 

Begin initialization! 

Q 


*v 



♦Y, QQTEST, 2, QQQ8AB, 3, QQSPAC, 4 

*YM, LOADSD, 1, JOBENT, 2, JOBPRO, 3, JPLOAD, 4 

*YM, JPST, 5, JPCHGE, 6, JBKILL, 7, JPT13, 8 

*YM, RCOVER, 9, LIBEDT, 10, MODI, 11, MOD2, 12 

*YM, MOD3, 13, BRKPT, 14, RESTOR, 15, MOD4, 16 

*YM, DEBUG, 17, DSUTIL, 18, TYPEID, 19, DSTART, 20, RSTART, 21 

*YM, QQFMTl, 22, QQCOM, 23, QQANAB, 24, QQUTLl, 25 etc. 


*Z 

J 

♦p 

J 

*SI 

J 
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14.4 TRANSFERRING RECORDS 

In this example, LIBEDT was used to transfer a card image from the card reader to 
paper tape. The *T image in the example was then attached to the end of a series of 
paper tape programs being loaded, to cause the loader to end loading. 


O 


o 
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TRANSFER RECORDS FROM ONE LUN TO ANOTHER 


LIBEDT *T (*T option is used to transfer rel. bin. paper 

tapes which are SI input to high portion of disk 
so that disk input may be made to SI. ) 


*Z 

J 

*p 

J 

*LIBEDT 

LIB 

IN 

*T,12,A, 11, a, 1 

IN Transfer from LUN 12 (CR), ASCII mode, to LUN 11 (FTP), 

ASCII mode, one record (1 card) 



CR LF 


14. 5 ABSOLUTIZING AND LINKING SUBPROGRAMS 


Next, LIBEDT was used to build a utopia system. This involves loading, absolutizing, 
and linking a series of relocatable binary paper tapes. Only the routines applicable to 
the particular configuration were included. The new utopia in core can then be used to 
punch out an absolute paper tape image of itself. 
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BUILD UTOPIA SYSTEM USING LIBEDT 


♦p 

J 

*LIBEDT 

LIB 


IN 

*K,I2,P11 

IN 


*P 

L,02 FAILED 02 

ACTION 

RP 

L,02 FAILED 02 

ACTION 

RP 

L,02 FAILED 02 

ACTION 

RP 

L, 02 FAILED 02 

ACTION 

RP 

L,02 FAILED 02 

ACTION 

RP 

L,02 FAILED 02 

ACTION 

RP 

L,02 FAILED 02 

ACTION 

RP 

L,02 FAILED 02 

ACTION 

RP 

L,02 FAILED 02 

ACTION 

RP 

L,02 FAILED 02 

ACTION 

RP 

L,02 FAILED 02 

ACTION 

RP 

L,02 FAILED 02 
ACTION 

CU 


] 



CaU in LIBEDT 

Assign input LUN 2 (PTR) output LUN 11 (FTP) 

Load and absolutize tapes 
UTOPIA 

UMAINF 

USILLY 

U1711 

UDISK 

CARDIN 

U1729 

ueaiMT 

UTODMP 

UDALP 

CKOUT 

UTLAST 

Wind up load and link 


E * Externals missing; ignore; pimch tape 

IN 

*Z ^ Sign off LIBEDT 

J 
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BUILD UTOPIA PRINT OUT 


UTOPIA 2210 
UMAINF 2392 
USILLY 25A8 
U1711 3258 

UDISK 343E 
CARDIN 3680 
U1729 3707 

U601MT 38A9 
UTODMP 39 BE 
UDALP 3AA2 
CKOUT 444A 
UTLAST 4F23 

ElO 

CKD 

PCR 

DKM 

MAR 

VDM 

LPRINT 

RDM 

WDM 










J 


Routine names and addresses where loaded 


Missing Externals 

(These are for modules not included in this 
system) 


Applicable Utopia routines for customer’s configuration can be loaded and linked to- 
gether, then an absolutized tape can be punched. It can then be loaded by a cksum 
loader (which must be loaded by a bootstrap loader). 

Utopia modules could also be loaded and linked and put on program library in rel bin 
form (with Libedt *L). Then Utopia could be called from TTY with *UTOPIA. 
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Ref. No. 


Reference Title 


1 

2 

3 

4 

5 

6 

7 

8 
9 

10 


Reference Manual 
Codes 

Assembler Reference Manual 

1700 Macro/ Assembler Reference Manual 

Utility Reference Manual* 

Operating System Reference Manual 
1700 4K Assembly System (ADB) 

Input/ Output Specifications Manual 
Systems Manual 

ADSD General Information Manual 


*Utility Assembler requires 8K system. 
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Publication No. 

60153100 

60163500 

60171600 

60176300 

60172300 

60174600 

60176500 

60165800 

60152900 

60187600 
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1700 INSTRUCTION EXECUTION TIMES 

STORAGE REFERENCE 

Execution Time 

Instruction (microseconds)* 


LDA 

Load A 

2.2 

STA 

Store A 

2.2 

LDQ 

Load Q 

2.2 

STQ 

Store Q 

2.2 

ADD 

Add A 

2.2 

SUB 

Subtract 

2.2 

ADQ 

Add Q 

2.2 

AND 

AND with A 

2.2 

EOR 

Exclusive OR with A 

2.2 

RAO 

Replace Add One in Storage 

3.3 

MUI 

Multiply Integer 

7.0 

JMP 

Jump 

1.1 

RTJ 

Return Jump 

2.2 

DVI 

Divide Integer 

9.0 

SPA 

Store A, Parity to A 

2.2 


*Add 1. 1 microsecond if Storage Index Register is used. 

Add 1. 1 microsecond for each level of Indirect Addressing. 
Add 1.1 microsecond for two word instructions. 

REGISTER REFERENCE 


Instruction 


Execution Time 
(microseconds) 


SLS 

Selective Stop 

INP 

Input to A 

OUT 

Output from A 

ENA 

Enter A 

ENQ 

Enter Q 

INA 

Increase A 

INQ 

Increase Q 

ARS 

A Right ShifO 

QRS 

Q Right Shift 

ALS 

A Left Shift 

QLS 

Q Left Shift 


1.1 

1. 1 min. , 10 max. 

1. 1 min. , 10 max. 

1.1 

1.1 o 

1.1 

1.1 


1. 1 + (shift count *. 1) 
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REGISTER REFERENCE (Cont) 


LRS 

LLS 

NOP 

EIN 

IIN 

EXI 

SPB 

CPB 


Instruction 


Execution Time 
(microseconds) 


Long Right Shift"^\ 
Long Left Shift _/ 


1.1 + (shift count *.2) 


No Operation 1. 1 

Enable Interrupt 1, 1 

Inhibit Interrupt 1. 1 

Exit Interrupt State 2, 2 

Set Program Protect 2. 2 

Clear Program Protect 2, 2 
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INTERREGISTER 



SET 

CLR 

TRA 

TRM 

TRQ 

TUB 

TCA 

TCM 

TCQ 

TCB 

AAM 

AAQ 

AAB 

EAM 

EAQ 

EAB 

LAM 

LAQ 

LAB 

CAM 

CAQ 

CAB 


Instruction 


Execution Time 
(microseconds) 


Set to Ones 

Clear to Zero 

Transfer A 

Transfer M 

Transfer Q 

Transfer Q V M 

Transfer Complement A 

Transfer Complement M 

Transfer Complement Q 

Transfer Complement Q V M 

Transfer Arithmetic Sum A, M 

Transfer Arithmetic Sum A, Q 

Transfer Arithmetic Sum A, Q V M 

Transfer Exclusive or A, M 

Transfer Exclusive or A, Q 

Transfer Exclusive or A, Q V M 

Transfer Logical Product, A, M 

Transfer Logical Product A, Q 

Transfer Logical Product A, Q V M 

Transfer Complement Logical Product A, M 

Transfer Complement Logical Product A, Q 

Transfer Complement Logical Product 

A, Q V M 
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SKIPS 


Instruction 


Execution Time 
(microseconds) 


SAZ 

SAN 

SAP 

SAM 

SQZ 

SQN 

SQP 

SQM 

SWS 

SWN 

sov 

SNO 

SPE 

SNP 

SPF 

SNF 


Skip if A = +0 
Skip if A ^ +0 
Skip if A = + 

Skip if A = - 
Skip if Q = +0 
Skip if Q +0 
Skip if Q = + 

Skip if Q = - 

Skip if Switch Set 

Skip if Switch Not Set 

Skip on Overflow 

Skip on No Overflow 

Skip on Storage Parity Error 

Skip on No Storage Parity Error 

Skip on Program Protect Fault 

Skip on No Program Protect Fault 
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APPENDIX C 


UTILITY ASSEMBLER PSEUDO INSTRUCTIONS 


NAM n 


END e 

ENT n^, . 

EXT ^2 > * • • 

EXT*n , n , , , . 

X ^ 

BSSn^(s^), 112(82) ... 

BZSn^(s^),n2(S2) ,... 

COMn^(s^),n2(S2) ... 

DAT n^(s^), 112(82) ,... 

ADC e , e , . . . 

X ^ 


ALE 


n 


2n characters 




NUM c , c , , . . 
X ^ 


First instruction in source program. The 
name, n, if given, identifies the program. A 
numeric location field for this instruction 
specifies the absolute starting location for the 
program; a symbolic location field is ignored. 

Last instruction in source program. The entry 
point, e, if given, is the start of the . program. 

Entry points, n^, that may be ref err ed to by 
other programs. 

External locations, n^, of other programs that 
are referred to by this program. 

Similar to EXT except that references to the 
external names, nj, are made relative. 

Reserves a block of program storage locations. 
The names, n^^, identify segments of Sj^ words in 
length. 

Similar to BSS. In addition, zero fills the block. 

Reserves a block of common storage locations. 
The names, n^^, identify segments of sj words in 
length. Data may not be prestored in the com- 
mon block. 

Reserves ablock of data storage locations. The 
names, n^, identify segments of sj words in 
length. Data may be prestored in the data 
block. 

Defines address expressions to be stored as 
address constants. The addresses may be posi- 
tive or negative and absolute or relocatable. 
Parentheses indicate indirect addressing. 

Stores ASCII alphanumeric characters into con- 
secutive locations of program storage. 

Stores decimal or hexadecimal constants, cp in 
consecutive locations in program storage. 
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UTILITY ASSEMBLER PSEUDO INSTRUCTIONS (CONT) 


ORG 6 
ORG* e 

EQU > • • • 

NLS 


Assemble subsequent instructions beginning at 
the address expression, e, which may be pro- 
gram relocatable, data relocatable or absolute. 

Resumes assembling instructions immediately 
after the location preceding the ORG instruction 
or the first ORG if more than one in a string. 

Equates names, n», to address expression, e*. 

Inhibits list output of assembly. 



LST 


SPG V 


Enables list output of assembly following is- 
suance of a NLS instruction, (Listing is auto- 
matic unless NLS is given. ) 

Spaces V lines on the typewriter. 
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c 
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ASSEMBLY ERROR MESSAGES 


ERROR LISTING 

A list of errors occurring in passes 1 and 2 precedes the program listing on the standard 
comment l/ O unit. If the L option is selected, errors in pass 3 precede the source line on 
the list output. A decimal error count is printed at the end of each subprogram. If L is not 
selected, error messages are output on the standard comment unit. 

Format for pass 1 and 2 error messages: 

Contents 

3 -digit line number 
space 

2-character error code 
Contents 

2-character error code 

Following are the error message codes and their definitions. 

Message Meaning 

**DS Doubly defined symbol. A name in 

1) location field of a machine instruction or an ALF, NUM, or ADC 
pseudo instruction 

or 

2) address field of an EQU, COM, DAT, EXT, BSS, or BZS pseudo 
instruction 

has been used again in one of the above fields. 

Undefined symbol in an address expression. 

Available storage for saving symbol names exceeded; no more names 
may be defined. Symbol table overflow. 



**UD 

**SO 


o 


Column 

1-3 

4 

5-6 

7-8 

Format for pass 3 error messages: 

Column 

1-6 

7-8 

9-18 
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Message 

Meaning 

**EX 

Illegal expression. One of the following: 

1) No forward referencing of some symbolic operands 

2) No relocation of certain expression values 

3) A violation of relocation 

4) Possibly a comment is being interpreted as an address field in an 
instruction which has no address field 

**LB 

Numeric or symbolic label contains illegal character. The label is 
ignored. 

**IX 

Illegal index register; specified by symbol other than Q, I or B. 

**op 

1) Illegal symbol in operation code field, e. g. , LDI TAG 

2) Illegal operation code terminator 

3) Could also be caused by error in macro 

**OR 

Numeric or symbolic operand in address expression contains illegal 
characters. 

**RG 

Illegal register for interregister instructions, e.g. , CLR I 

1) Symbol other than A, Q, or Mused in address field of interregister 
instruction, or the same symbol used more than once. 

2) Registers separated by other than a comma. 

**RL 

1) Violation of relocation. 

2) Violation of a rule for instructions which require the expression 
value to 

a) be absolute 

b) have no forward referencing of symbolic operands. 

**ov 

Numeric operand overflow-numeric value greater than allowed, e. g. , 
1 wd. rel. more than $7F. 

**SQ 

Sequence error 

**MD 

Macro definition error 

**MC 

Macro instruction error 

**PP 

Error in previous pass of compilation 

**NN 

No NAM statement. Blank name will be inserted by assembler. 

**MO 

Overflow of the load-and-go area of mass storage. 
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LOADER ERROR MESSAGES 

All loading error messages appear on the standard print output device. 

EOl Irrecoverable input error; terminates loading. 

EOS Illegal or out-of-order input block; terminates load. Also, this diagnostic appears 

on the comment device when illegal input from that device is detected. The comment 
device is interrogated for a new statement. 

E04 Incorrect common block storage reservation. Occurs if the first NAM block to de- 
clare common storage does not declare the largest amount. The loader uses the 
previously declared length and continues. 

EOS Program too long or loader table overflow. Terminates loading. Occurs if program 
to be loaded exceeds available unprotected core. It may be possible to load the pro- 
gram by rearranging the order of loading to insure entry points are defined before 
they are referred to as external symbols. Loader produces a memory map and list 
of unpatched externals prior to terminating the load. 

E06 Attempt to load information in protected core; terminates loading. 

EOT Attempt to ORG into part of data storage beyond assigned block; terminates loading. 

EOS Duplicate entry point; loading continues. The succeeding program is loaded, over- 

laying the program with the duplicate entry point. 

ElO Unpatched external. External name is printed following diagnostic. The operator 
may choose to terminate the job or continue execution in spite of unpatched exter- 
nals (with *(CR)). A *E(CR) will cause the loader to search the directory of core 
resident entry points for the missing external. 

Ell Error in HEX block; loader skips remainder of block and resumes loading with the 
next block. Image of HEX block in error is printed following diagnostic. 

E12 Two programs reference same external name, one with absolute addressing, the 
other relative addressing. 

E13 Undefined or missing transfer address; occurs when loader does not encounter a 
name for the transfer address to begin execution, or the name encountered is not 
defined in loader’s table as an entry point name. 
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JOB PROCESSOR ERROR MESSAGES 


PARITY, hhhh 
OV 

L,nn FAILED ee 


ALT, aa 
ACTION 

J01,hhhh 

J02,hhhh 

JOS, statement 

J04, statement 

JOS 

J06,hlihli 

JOY, hhhh 
JOS, hhhh 


Memory parity error at location hhhhj^ 0 . Message appears on output 
comment device. 

Overflow of volatile storage. Message appears on output comment 
device. 

Informs operator of device failure, 
nn logical xmit number 

ee code indicating cause of failure as follows: 

00 I/O hangup 

01 Internal or external reject 

02 Alarm 

03 Parity error 

04 Checksum error 

05 Internal reject 

06 External reject 

Informs operator an alternate device, aa, has been assigned. 

Requests operator action when a failed device has no alternate. The 
device is identified in the FAILED diagnostic. 

Program protect violation, hhhh is current contents of P register. 
Standard print output device. 

Illegal request or parameters at location hhhh^g. Standard print out- 
put device. 

Unintelligible control statement is output with the diagnostic. Standard 
output device. 

Illegal or unintelligible parameters in control statement. Standard 
print output device. 

Statement entered after manual inter rupt illegal. Output comment 
device. 

A threadable request was made at level one when no protect processor 
stack space was available, or an improtected threaded request was 
made at level one. Standard print output device. 

Unprotected program tried to access protected device from location 
hhhh. Standard print output device. 

Attempt to access readonly unit for write, or write only unit for read, 
or an attempt to access an unprotected request on a protected unit. 
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AMERICAN STANDARD CODE FOR INFORMATION INTERCHANGE (ASCII) 


Bit Configuration 

Symbol 

Bit Configuration 

Symbol 

000 

0000 

NUL 

001 1011 

ESC 

000 

0001 

SOH 

001 1100 

FS 

000 

0010 

STX 

001 1101 

GS 

000 

0011 

ETX 

001 1110 

RS 

000 

0100 

EOT 

001 nil 

US 

000 

0101 

ENQ 

010 0000 

SP 

000 

0110 

ACK 

010 0001 

I 

000 

0111 

BEL 

010 0010 

tT 

000 

1000 

BS 

010 0011 

# 

000 

1001 

HT 

010 0100 

$ 

000 

1010 

LF 

010 0101 

% 

000 

1011 

VT 

010 0110 

& 

000 

1100 

FF 

010 0111 

f 

000 

1101 

CR 

010 1000 

( 

000 

1110 

SO 

010 1001 

) 

000 

nil 

SI 

010 1010 

* 

001 

0000 

DLE 

010 1011 

+ 

001 

0001 

DCl 

010 1100 

» 

001 

0010 

DC2 

010 1101 

- 

001 

0011 

DCS 

010 1110 

• 

001 

0100 

DC4 

010 nil 

/ 

001 

0101 

NAK 

on 0000 

0 

001 

0110 

SYN 

on 0001 

1 

001 

0111 

ETB 

on 0010 

2 

001 

1000 

CAN 

on 0011 

3 

001 

1001 

EM 

on 0100 

4 

001 

1010 

SS 

on 0101 

5 
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ASCII (Cont) 


Bit Configuration 

Symbol 

Bit Configuration 

Symbol 

Oil 0110 

6 

101 0010 

R 

Oil 0111 

7 

101 0011 

S 

Oil 1000 

8 

101 0100 

T 

Oil 1001 

9 

101 0101 

U 

Oil 1010 

; 

101 0110 

V 

Oil 1011 

> 

101 0111 

w 

Oil 1100 

< 

101 1000 

X 

Oil 1101 

= 

101 1001 

Y 

Oil 1110 

> 

101 1010 

z 

Oil 1111 

9 

101 1011 

[ 

100 0000 

\ 

101 1100 


100 0001 

A 

101 1101 

] 

100 0010 

B 

101 1110 

A 

100 0011 

C 

101 nil 

- 

100 0100 

D 

no 0000 

@ 

100 0101 

E 

no 0001 

a 

100 0110 

F 

no 0010 

b 

100 0111 

G 

no 0011 

c 

100 1000 

H 

no 0100 

d 

100 1001 

I 

no 0101 

e 

100 1010 

J 

no 0110 

f 

100 1011 

K 

no 0111 

g 

100 1100 

L 

no 1000 

h 

100 1101 

M 

no 1001 

i 

100 1110 

N 

no 1010 

j 

100 nil 

O 

no 1011 

k 

101 0000 

P 

no 1100 

1 

101 0001 

Q 

no 1101 

m 
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ASCII (Cont) 




Bit Configuration 
110 1110 
no nil 
111 0000 
111 0001 
111 0010 
111 0011 
111 0100 
111 0101 
111 0110 
111 0111 
111 1000 
111 1001 
111 1010 
111 1011 
111 1100 
111 1101 


111 1110 

111 nil 



V-/ 


Symbol 

n 

o 

P 

q 

r 

s 

t 

u 

V 

w 

X 

y 


z 



DEL 
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ANSWERS TO EXERCISES ON CHAPTER II 


1. a. 0010 1101 1010 1110 is2DAE,^ 

16 

b. 1000 1111 1100 0111 is8FC7,^ 

lo 

c. nil nil 1100 0000 is ffco,^ 

16 

2DAE,e = 11694^^ 

8FC7_ = -28728_ 


FFCOie = -63^^ 


2DAE^g + 8FC7^g + FFCO^^ = 

BD75_ + FFC0_ = BD36_ 
16 16 16 

No overflow was generated. 


2. a. 

4095, „ = 0FFF,„ 
10 16 

= 0000 

nil 

nil 

nil 

b. 

-1^0 = ^^^^16 = 

nil 

nil 

1110 

llio^ 

c. 

255io = OOFF^g = 

0000 

0000 

nil 

11112 


3. By extending the sign. Consider the 8 bit positive number: 

j 

ObOOOill^ - Decimal value 7 

t 

I Sign Bit. Extend the sign bit to the left 8 places - 0000 0000 0000 OIII2 - same value 
of 7 but the number now occupies a 16-bit field. 

The same applies for a negative number. FE^gis -1 in an 8-bit field and FFFE]^0 is also 
-1, but in a 16-bit field. 
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ANSWERS TO EXERCISES ON CHAPTER V - Shift and Skip Instructions 

1. a. Shifts QA left 16 bits. This effectively switches the data in A to Q and Q to A. 

b. Will JUMP to P + 4 if the overflow indicator is on, and clear the indicator. Will go 
to P + 1 if overflow indicator is not on. 

c. Shifts the data in Aright 18 bits. This will clear A if bit 15 was originally a 0 or will 
set A to all I’s if bit 15 was originally a 1. It also wastes time since the maximum 
necessary shift count to accomplish the same result is 15. 

d. Neither the A nor the Q register is specified so the instruction is essentially a time 
delay. It takes l.l + .lx8 = 1.9 microseconds to execute and does nothing to the A 
or Q registers. 

2. Q = 0000 

A = E3C4 



ANSWERS TO EXERCISES ON CHAPTER V - Constant Mode of Addressing 


1. a. 

A = 

1059 

Q = 0000 

b. 

A = 

0024 

Q = 0000 

c. 

A = 

4142 

Q = 4040 



ANSWERS TO EXERCISES ON CHAPTER V - Absolute Mode of Addressing 


LDA- 

$FF 

ADD 

=N$10 

STA- 

$FF 

also 

LDA- 

I 

ADD 

=N$10 

STA- 

I 


I can be used in place of $FF for storage reference class of instructions. One-word ab- 
solute mode is used since $FF is in the communications region. 

2. a. 4016 

b. 003F 

c, 4016 (However, this is two-word absolute indirect which requires two core cells 

and 1. 1 microseconds more time. Since the base address is in the commu- 
nications region, one-word absolute indirect should be used. ) 

3. a. This will decode as COOO; A will be 0, yielding not one-word absolute but the first 

word of constant mode. The base address for one-word absolute must be 01 to FF. 

b. One-word absolute could have been used since the base address is F3. 

c. Nothing. This is a legitimate example of two-word absolute indirect. Bit 15 of the 
second word (P+1) will be set because of the parentheses and bits 14-0 of P+1 will 
contain the address equivalent for TEST. 
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ANSWERS TO EXERCISES ON CHAPTER V - Relative Mode of Addressing 



1 . 


a. Forward, 31 hex locations from P, 

b. Backward, 1000^^ or 4096^^ from P+1, or OFFF^ ^ or 4095^^ from P. 

lb 10 16 10 

c. Backward, one location back from P. 


2. a. Two-word relative 

b. One-word absolute indirect 

c. Two-word absolute indirect 

d. One-word relative 

e. Constant. Two-word. 

f. Two-word relative indirect 

g. Constant. Two-word. 

h. One-word absolute 


3. The communications region is fixed and will never move with the program. If the pro- 
gram moved and not the communications region, the relative distance which had been 
established would be worthless. Fixed areas of core are addressed absolutely, and those 
that move with the program are addressed relatively. 
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ANSWERS TO EXERCISES ON CHAPTER V - Indexing 

1. a. B is used to indicate use of both Q and I index registers. Should be written 

LDA AB, B. 

b. Nothing, if A is defined as a legitimate symbol elsewhere in the program. 

c. No indexing with shift class instructions, only storage reference class, 

2. a. A = 0000 

b. A = 0023 

c. A = 0023 

3. It will loop forever since the reduced index register I value is never stored back. Need 
a STQ- I after the ADQ =N-1. 

Answer to indexing problem: 

a. $1234 

b. $02ED 

c. $2311 

d. $1111 



ANSWERS TO EXERCISES ON CHAPTER VI - Utility Assembler 



1. a. Symbols for the EQU and BSS pseudo ops are defined by appearing in the address 
field. 


b. TAG is a doubly defined symbol. It cannot be an EXT. 


c. START should be an entry point. The program should look like: 


Location 

Opcode 

Address 


NAM 

EXAMP 


ENT 

START 


EQU 

LED(720) 

TAG 

NUM 

-72, $FFFF,72 


BSS 

TAG11(25) 


EXT 

LAD 

START 

LDA+ 

TAG 


STA-f 

LAD 


END 

START 


Comments 


2. The common area cannot be preset. 



3. Since the common area is fixed, all references to it can safely be made absolutely. This 
is necessary instead of a relative addressed mode for run an 5 rwhere programs. 


4. When the reference is made to LIST+3, the operand is unpredictable. The loader skips 
over the LIST area at load time. A BZS should have been used. It would be worthwhile 
at this point to refer to reference 5 or 6 for more information concerning the loader since 
this information is not covered in this manual. 
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ANSWERS TO EXERCISES ON CHAPTER VI - Macro Assembler 


a. 

FEE9 


002F 

b. 

4142 

c. 

OAOO 

d. 

FFFE 


2. LDA 

=N$1000 


ADD 

=N$1000 


3. TAG 

ALF 

Z,ERROR6 Z 

TAGl 

ALF 

Z, LOGICAL UNITS 


4. The symbol TE is declared local to the macro and cannot be called by the main program 
Also, since the code is inserted in-line, the $7FF3 could be executed as an instruction 
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ANSWERS TO EXERCISES ON CHAPTER VIII 



LOOP 


FIRST 


STA* 

FIRST 

ENA 

$20 

LDQ 

=N$A1 

OUT 

-1 

INQ 

-1 

INP 

-1 

SAN 

1 

JMP* 


INP 

-1 

ALS 

8 

INP 

-1 

STA* 

(FIRST) 

RAO* 

FIRST 

JMP* 

LOOP 

ADC 

0 


a. This program is run anywhere. 

b. Starting location for the checksum program is initially placed in the A register. 

c. Reader will run out of tape and stop on a lost data condition. 




F-9 




APPENDIX G 




c 



APPENDIX G 


SOLUTIONS TO PROBLEMS IN CHAPTER V 


ADDRESSING PROBLEM 

a. 1234 

b. 02ED 

c. 2311 

d. 1111 

MOVE 

The MOVE routine moves 1001^^ numbers from $1000-$2000, inclusive, to $3000-$4000, in- 
clusive. 


$2000 


$1000 



SUM 

The SUM routine sums 10012^0 numbers from $1000-$2000, inclusive. The answer is stored 
in $3000. 


$2000 


$1000 


A 


sum 
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CHNG 


The CHNG routine swaps two arrays, inverting them. The contents of locations $1000-$2000 
are swapped and inverted with the contents of locations $3000-$4000, 


$2000 


$1000 


The swap is completed when the last address in ADDR has been decremented past $3000. 

SUB 

The SUB program picks up the actual data from the calling program and stores them in its 
locations SUBAGl, SUBAG2, and SUBAG3. The E OR =N$8000 put an indirect bit on the 
contents of location SUB (which in the example was $502). This caused the LDA* (SUB) to get 
the actual data, 10, etc. After picking up all the data, the subroutine updated the return ad- 
dress to $505 and ANDed off the extra indirect bit, AND =N$7FFF, so the return would be' 
to the proper place. 

The subroutine saved the registers when it was entered, and restored them when it exited, 
which most subroutines would do. 

SORT 

The SORT routine sorts 16 numbers, in ascending order, in core locations $500-$50F, in- 
clusive. The method used is to push the smallest number to the top, the next smallest number 
to the next-to-top, etc. 

CLRPB 

The CLRPB subroutine clears protect bits on the core area from$2000-$4000, inclusive. The 
parameters passed by the calling routine are the last word address of the buffer (LWA) and 
the first word address (FWA). The subroutine will work for any addresses passed to it. It 
uses the A register and overflow indicator for loop control. When the last word address is 
subtracted from $7FFF in A, the number left will be such that when Q reaches the last word 
address +1 and the AAQ 0 instruction is executed, overflow will occur, and the exit will be 
made from the loop. The SOV 0 instruction before entering the loop turned off the overflow 
indicator in case it may have been on. The CLRPB subroutine must be a protected routine 
itself or the protect switch must be off. 



$4000 


$3000 
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CONVRT 



The CONVRT subroutine converts a hexadecimal number which it receives in A to the ASCII 
codes for the decimal number. It packs the codes in a buffer, BUF, and returns to the caller 
with the buffer address in A. 

The method used is to divide the number by 10, in hexadecimal arithmetic, and save the re- 
mainders. Each time a divide is done, the remainder in Q will be used to get the ASCII code 
for the number from a table, TAB. 

It would have been possible in this example to simply add $30 to each remainder for the con- 
version. However, the table-look-up method is used for illustration. Also note that the 
routine puts the characters in one buffer, BUFl, then packs them in BUF for the caller. 

The CONTST program checks out CONVRT by calling it to convert a number $37 CO, then 
writing the answer on the teletypewriter in ASCII. 
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SOLUTIONS TO PROBLEMS IN CHAPTER VI 


VALUE 

PROBLEM 



NAM 

TEST 


COM 

DUMMY(10),X(10) 


DAT 

DUM(6), COUNT (1) 


EQU 

LPMASK($2) 


ENT 

START 


EXT* 

VALUE 

MASK 

BZS 

MASK(l) 

START 

0 

0 


CLR 

Q 


STQ 

COUNT 


LDA 

VALUE 


AND- 

LPMASK+6 


ALS 

8 


STA* 

!mask 


ENQ 

9 

SEARCH 

LDA+ 

X,Q 


AND 

=N$3F00 


EOR* 

MASK 


SAN 

2 


RAO 

COUNT 


SQZ 

EXIT-*-l 


INQ 

-1 


JMP* 

SEARCH 

EXIT 

JMP* 

END 

(START) 


NAM gives the program a name. ENT gives it an entry point. START is where execution 
begins, but it does not appear on the END card, implying that it is a subroutine. COM de- 
clares the X's in COMMON; COUNT declares the 7th word of the data block for the answer. 
DUMMY and DUM space over locations not used in this program. The EXT* declares VALUE 
external (it must be an entry point in the other program), and the * implies it is relative. 
The BZS initializes MASK to 0. The EQU declares that LPMASK is location $2. 

INI MACRO 

The two listings on the following pages show one way to write the INI macro. The first 
listing does not have the macro expanded, while the second does (M option). 

The test routine was run with the STOP switch set. When the computer stopped, the Q reg- 
ister was selected on the console for display. It contained a 6, to indicate that the macro 
worked. 

The INI is not exactly like an INA or INQ because of the size of operands allowed. Line 0008 
has an ADD =N’N’ instead of an INA ’NL 
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0001 




NAM 

INIMAC 

0002 



INI 

MAC 

N 

0003 




LOC 

SA 

0004 




JMP* 

*♦2 

0005 



•5A* 

NUM 

0 

0006 




STA<> 

•SA« 

0007 




LDA- 

I 

0008 




ADD 

=N*N» 

0009 




STA- 

I 

0010 




LDA* 

• SA« 

0011 




EMC 


0012 




ENT 

INIMAC 

0013 

POOOO 

0000 

TNTMAC 

0 

0 

0014 

POOOl 

0842 


CLR 

Q 

0015 

P0002 

40FF 


STQ- 

I 

0016 




INI 

6 

0016 

P0003 

1802 




0016 

P0004 

0000 




0016 

P0005 

68FE 




0016 

P0006 

COFF 




0016 

P0007 

8000 





P0008 

0006 




0016 

P0009 

60FF 




0016 

POOOA 

C8F9 




0017 

POOOB 

FOFF 


LDQ- 

I 

0018 

POOOC 

0000 


SLS 


0019 




END 

INIMAC 




I OOFF INIMAC OOOOP [00 

0004P 
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0001 




NAM 

INIMAC 

0002 



INI 

MAC 

N 

0003 




LOC 

SA 

0004 




JMP* 

*♦2 

0005 



*SA« 

NUM 

0 

0006 




STA« 

•SA« 

0007 




LDA- 

I 

0008 




ADD 

=N»N* 

0009 




STA- 

I 

0010 




LDA» 

•SA* 

0011 




EMC 


0012 




ENT 

INIMAC 

0013 

POOOO 

0000 

INIMAC 

0 

0 

0014 

POOOl 

0842 


CLP 

Q 

0015 

P0002 

40FF 


STQ- 

I 

0016 




INI 

6 

0016 

P0003 

1802 


JMP* 

*♦2 

0016 

P0004 

0000 

[00 

NUM 

0 

0016 

P0005 

68FE 


STA<^ 

[00 

0016 

P0006 

COFF 


LDA- 

I 

0016 

P0007 

8000 


ADD 

=N6 


P0008 

0006 




0016 

P0009 

60FF 


STA- 

I 

0016 

POOOA 

C8F9 


LDA* 

[00 

0017 

POOOB 

EOFF 


LDQ- 

I 

0018 

POOOC 

0000 


SLS 


0019 




END 

INIMAC 


I OOFF INIMAC OQOOP fOO OOQ4P 



SOLUTION TO PROBLEMS IN CHAPTER VIII 


CKASSM PROBLEM (8. 4) 

The first INDIR request, line 13, is for the write request at line 34, out of the buffer MSG, 
line 25, on the teletypewriter. "NEXT MESSAGE SHOULD INDICATE VERIFICATION." 

The next, at line 15, is to start the write request at line 32 to write a message from MSGl, 
line 26, on the disk. "MACRO ASSEMBLER ON 1700 NOW OK. " This message will be written 
on the disk concurrently with the first message which is going out on the TTY. 

At line 16, a status request is made to wait for the disk write to finish. Then, at line 19, the 
message on the disk is read back in, line 28, into a different buffer, BUF, which is a BZS at 
line 27. At line 20, status is taken from line 28 to wait for completion of the disk read. 
Finally, tliis message is transferred out of BUF to the teletypewriter at line 23, after which 
an exit is made at line 24. 

The program works out the assembler by the assortment of requests used to transfer the 
message around. Note that no completion routines are used; it will be obvious that if the two 
messages come out, it worked; and if they don’t, it didn’t. 

The errors which could be found are: 

1. SQN 1 at lines 17 and 21. This is the main error and the instruction effectively doesn’t 
do anything. It was intended to loop on the indirect status request until the operation in 
progress bit (bit 15 of Q) became clear. To accomplish that, a SQP instruction should 
have been used. Since Q is word 8 of the disk physical device table, it will never be a 
whole word of zero (upon which the SQN could be used). Only bit 15 should be checked 
for zero. Therefore, as the program is set up, control falls right through to initiate the 
disk read at line 19, then the teletypewriter write at line 23. 

The program works because of the speed of the peripherals involved and the threading of 
requests onto the driver for each logical unit. The correct message is written, not 
garbage. 

What actually happens (if the SQN’s are used instead of SQP’s) is: 

a. The first TTY message is initiated. 

b. The disk write is initiated. 

c. The disk read is initiated; it is threaded onto the disk driver after the disk write, 
since both are at priority 0. Therefore, the read will not be done until the write is 
finished. 

d. The second TTY write is initiated and is threaded on behind the first write, again 
since the priority is the same (RP = 0). That is why the second line comes out after 
the first, as it should. 

e. The second line does not contain garbage because the TTY is slow compared with the 
disk; the disk buffer has been written and read back in before the TTY driver gets 
ready to write it out. Any change in hardware or priorities involved could cause a 
mess. 
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2. The next item to note is the binary write on the teletypewriter at line 23. Normally an 
ASCII write would be used. No damage is done because the words being written already 
contain ASCII characters which can be sent directly to the teletypewriter. 

3. Note the formatted write and read on the disk. This is not an error but implies that the 
disk sector driver is in the system, not the disk word driver. 

4. Note the disk sector address words which must be inserted after the macros at lines 30 
and 33. They indicate sector 1 in the scratch area. This is not an error. 

The version of the CKASSM routine which is used to check out the macro assembler contains 
SQN instructions at P0007 and POOOD. This is probably to test the status request itself and 
then also to check out the operation of MSOS. 
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SOLUTIONS TO PROBLEMS IN CHAPTER XI 


SOLUTION TO RUN ANYWHERE PROBLEM 

Program AVERAGE is written as a nondestructive run anywhere subroutine which may be 
called to compute an average. The buffer address in the calling routine is X, and the number 
of words is 10. Note that all of the addressing in the program is relative. 


0001 




NAM 

AVERAGE 


0002 




EXT* 

X 

RELATIVE EXTERNAL X 

0003 




ENT 

AVG 


0004 

POOOO 

0001 


BZS 

OVFL(l) 


0005 

POOOl 

0000 

AVG 

0 

0 


0006 

P0002 

0C09 


ENQ 

9 

N WORDS 9 

0007 

P0003 

OAOO 


ENA 

0 

CLEAR A AND OVFL 

0008 

P0004 

68FB 


STA* 

OVFL 

RELATIVE TO OVFL 

0009 

P0005 

OlAO 


SOV 

0 


0010 

P0006 

8A00 X 

LOOP 

ADD 

X,Q 

2 WORD RELATIVE EXT 


P0007 

7FFFX 





0011 

P0008 

01 B3 


SNO 

TEST-*-l 


0012 

P0009 

D8F6 


RAO* 

OVFL 

RELATIVE TO OVFL 

0013 

POOOA 

AOOO 


AND 

=N$7FFF 



POOOB 

7FFF 





0014 

POOOC 

0142 

TEST 

SQZ 

AV-*-l 


0015 

POOOD 

ODFE 


INQ 

-1 


0016 

POOOE 

18F7 


JMP* 

LOOP 

RELATIVE TO LOOP 

0017 

POOOF 

E8F0 

AV 

LDQ* 

OVFL 

RELATIVE TO OVFL 

0018 

POOlO 

OFCl 


ALS 

1 


0019 

POOH 

0F61 


LRS 

1 


0020 

P0012 

3000 


DVI 

=N10 



P0013 

OOOA 





0021 

P0014 

ICEC 


JMP* 

(AVG) 

RELATIVE TO AVG 

0022 




END 
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PROBl calls AVERAGE and punches out the answer, 4, and remainder, 5. The program is 
run anywhere, and note the relative addressing used in the punch request. ANS is before the 
request and COMPL is after the request. 



0001 




NAM 

PROBl 


0002 




EXT* 

AVG.IOERR 

RELATIVE EXTERNAL AVG 

0003 




ENT 

START, X 


0004 

POOOO 

0001 

X 

NUM 

1,2, 3, 4, 5, 6,7, 8,9,0 



POOOl 

0002 






P0002 

0003 






P0003 

0004 






P0004 

0005 






P0005 

0006 






P0006 

0007 






P0007 

0008 






P0008 

0009 






POOOO 

0000 





0005 

POOOA 

0003 

ANS 

BZS 

ANS(3) 


0006 


OOEA 


EQU 

ADISP($EA) 


0007 

POOOD 

5800 X 

START 

RTJ 

AVG 

TWO-WORD RELATIVE EXT 


POOOE 

7FFF X 





0008 

POOOF 

6800 


STA 

ANS 

RELATIVE TO ANS 


POOlO 

FFF9 





0009 

POOH 

4800 


STQ 

ANS+2 



P0012 

FFF9 





0010 

P0013 

54F4 


RTJ- 

($F4) 

PUNCH OUT ANS AND REM 

0011 

P0014 

0501 


NUM 

$0501 

SET X BIT 

0012 

P0015 

0007 


ADC* 

COMPL+1 

RELATIVE TO COMPL (FWD) 

0013 

P0016 

0000 


NUM 

0 


0014 

POOH 

0003 


NUM 

$0003 


0015 

P0018 

0003 


NUM 

3 


0016 

POOlO 

7FF5 


ADC 

ANS-*+5 

RELATIVE TO ANS 

0017 

POOIA 

14EA 


JMP- 

(ADISP) 


0018 

POOIB 

0162 

COMPL 

SQP 

2 


0019 

POOIC 

5800 X 


RTJ 

lOERR 



POOID 

7FFF X 





0020 

POOIE 

18FF 


NUM 

$18FF 

HANG WHEN FINISHED 

0021 




END 

START 
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Here is an error example of incorrect relative addressing used in the punch request. Note at 
line 16 that the ADC* ANS+5 assembles as FFF5, because ANS comes before the ADC in the 
program. A positive increment is required, relative to the first word of the parameter 
string, so it should have been 7FF5. The ADC ANS-*+5 should have been used. 

In debugging this program, the punch tape was studied. (Be sure to get it right side up. ) 
Note that the codes punched are: 

03 

FF 

F5 

14 

EA 

By studying the output, it was noticed that these are the codes for part of the program, in- 
dicating that the buffer ANS was not output, but program codes were. Hence the discovery of 
the FFF5 at P0019. 


G-11 



0001 
0 0 0 ? 

0003 

CO 04 POOOO 0001 X 

pooni 0002 

HO 00? 0003 
H0003 O004 
H0004 0005 
HO 005 0006 
POO 06 0007 
POO 07 00 OB 
POOOB 0009 
h0009 0000 ■ 

0005 POOOA 0003 ANS 

0006 OOEA 

0007 POOOn 5B00 X START 
HO OOP 7FFF X 

0008 POOOP' 6800 
HOOlO FFF9 


f' J A H 
FXT^J- 
ENT 
NNN 


PROBl 
AVG, lOFRR 


START, X 

1 ,2, 3, 4, 5, 6, 7, 8, 9,0 


37 S AMS (3) 

FOU AniSP($EA) 
RTJ AV/G 

STA AMS 


0009 

Pool 1 

4800 

STQ 

AMS + ? 


Pool? 

FFF9 



0010 

PG013 

54F4 

RTJ- 

($F4) 

001 1 

Put) 14 

0501 

NUM 

$0501 

001? 

Pools 

0007 


COMPL+1 

0013 

P 0016 

0000 

- - NUN- 

0 

0014 

POO 17 

0003 

MUM 

$0003 

0015 

HOOIB 

000 3 

MUM 

3 

0016 

POO 19 

FFF5 

( AOC^ 

A MS +5 

0017 

pool A 

14EA 

. JMP- 

(AOISP) 

0018 

POO IH 

0162 

COM PL SOP 

2 

0019 

POO 1C 

580 0 

X RTJ 

lOERR- 


POO 10 

7FFF 

X 


0020 

POOIF 

IRFF 

MUM 

$18FF 

00?1 



END 

START 
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In order to verify that the programs were indeed run anywhere and nondestructive and did link 
correctly, coding was inserted to move them (after they ran one time) to higher core and run 
again. Two identical answers would indicate that the programs did run correctly. 

The following example includes coding added which will move 100-j^Q words, beginning at 
START, to $4000, and then jump to $4000 to re execute. This continues repeatedly. Since 
the program lengths are 28;|^0 and for a total of 45 ^ 0 , the 10 ^^^ words moved is 

sufficient. 

Another method would be to use the contents of locations $F7 and $ED to find the core address 
and program length, and use them in the move. 

When checkout methods such as this are used, remember that if the breakpoint package is in 
core it is physically located immediately above the last subroutine. Therefore, it would be 
wise not to move the programs on top of the breakpoint package and wipe it out. 
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0001 





MAH 

PROBl 

0002 





EXT<^ 

AVG,IOERR 

0003 





ENT 

START, X 

0004 


OOFA 



EQU 

AOISP(SEA 

0005 

20 0 00 

5800 

X 

START 

RTJ 

AVG 


POO 01 

7FFF 

X 




0006 

P0002 

6800 



STA 

AMS 


P0 00 3 

0024 





0007 

P0 004 

4800 



STQ 

AMS + 2 


POO 05 

0 024 





0008 

POO 06 

54F4 



RTJ~ 

(SF4) 

00 09 

POO 07 

0 501 



NUH 

S0501 

0010 

PO 008 

0007 



ADCi^ 

COMPL+1 

,0011 

P0009 

0000 



MUM 

0 

0012 

POOOA 

0003 



MUM 

S0003 

0013 

POOOR 

0003 



MUM 

3 

0014 

POOOC 

0020 



ADC 

ANS— ^ + 5 

0015 

POOOD 

14EA 



JMP- 

(ADISP) 

0016 

POOOE 

0162 


COMPL 

SOP 

2 

0017 

POO OF 

5800 

X 


RTJ 

lOERR 


Pool 0 

7FFF 

X 




0018 

POOll 

OAOO 



ENA 

0 

0019 

POO IP 

60FF 



STA- 

I 

0020 

P0013 

C9EC 


LOOP 

LOA^^ 

START, I 

0021 

f •’ 0 014 

6500 



STA + 

$4000» I 


POO 15 

4000 





0022 

P0016 

OOFF 



RAO- 

I 

0023 

POO 17 

COFF 



LDA- 

I 

0024 

P0018 

099C 



INA 

-99 

0025 

POO 19 

0101 



SAZ 

OUT 

0026 

pool A 

1BF8 



JMP^ 

LOOP 

0027 

POOIB 

1400 


OUT 

JMP + 

$4000 


POO 1C 

4000 





0028 

POO 10 

000 1 


X 

MUM 

1,2, 3, 4, 5 


POO IF 

0002 






POOIF 

0003 






P0020 

0004 






P0021 

0005 






P0022 

0006 






P0023 

0007 






P0024 

0008 






P0025 

0009 






P0026 

0000 





0029 

P0027 

0003 


ANS 

BZS 

ANS(3) 

0030 





END 

START 


MOVE 


8,9,0 
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To illustrate the use of the conversion routine, the following program MAIN calls AVG to com- 
pute an average, then calls CONVRT to convert the answer (which was returned in A by AVG). 
CONVRT returns a 3-word buffer address of the ASCII characters (in A) which the main pro- 
gram then stores down in the write request. 

Note that this is an absolute buffer address. The completion address, COMPL, must also be 
absolute, yet it is in the rim anywhere program MAIN. For that reason, the program must 
absolutize the completion address at each run and store it at C in the write request. 

After the answer is computed once, MAIN calls the MOVE subroutine to move everything 
except CONVRT up to higher core locations, immediately following the original programs. 
Absolute addressing is used in MAIN to CONVRT so that the original copy of CONVRT is used 
for conversion, since it is not a run anywhere program. 

This would simulate a mass memory module using a core resident subroutine which always 
remained in the same place. Even if CONVRT had been moved, the original copy would still 
have been the one called. 

Note also that the flag used to control the move is addressed absolutely. This is so the ori- 
ginal flag in core will be used: set by one routine and checked by another. This will simulate 
run anywhere routines communicating with each other through a core resident flag cell. In 
the current example, the flag could have been addressed relatively. 
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FRAN GIACOBBE - PHILA 





0008 


0010 


0012 POO 01 0 000 T 

f\ n ^ ^ r\f \ r\ r\ nu c r 


OOU P0003 8000 

nnf\f\ /. i\ f\ \ r> 


0015 P0005 6808 

f\ r\ ^ ^ r>. r\ r% n z' j”ri/./A w 


P0007 7FFF X 

r» T TT /A rt r\ ri t~ /. t\ r\ w 


P0009 7FFF X 

n r\ 1 a n n n n a a i t 


0019 POOOH 54FA WRITE RTJ- 

r\ f\'^ r\ r\ r\ r' n n i Miik>i 


0021 POOOD 0000 C ADC 

nnoo Dnnnc nnnt\ miim 


0023 POOOF 1004 NUM 

f\ f\^ /. Pi A n 1 n /A n n ^ mi ioa 


0025 POOH 0000 ADC 

• IT A 


MAIN MUST BE LOADED FIRST* CONVRT LAST* FOR CHECKOUT 


0 

I r\ A -{> 


ADD 


STAi^ 


0027 POOIS 0161 COMPL SOP 

j. 1 oir tr MIIM 


0029 P0015 C400 CKMOVE LDA+ 
nnpc; d 


0030 POOH 0101 SAZ 

1 « iTkt A IMD — 


0032 POOIP 1800 X GOMOVE JMP 

onniA 7trt.r y 


0033 POOIB 15F9 

Dnnir vrcT 


POOID 0065 


POOIF 0000 


P0021 0008 


P0023 0004 


0034 P0025 0001 MVFLAG BZS 


=XCOMPL-T 


C 


(SF4) 

(t f \ I 


0 

n 


$1004 

O 


0 
I 


CKMOVE 

flirc- WAM 


MVFLAG FIRST OR SECOND RUN? 


GOMOVE-^-1 

/ A \ 


MOVE 


$15F9*$7FFF*$65*2*0*$100D*8*$12*4,3 


MVFLAG(l) 



WRITE OOOBP C 


OOODP COMPL 0013P CKMOVE 0015P GOMOVE 0019P 












c 


000? 

0003 





EXT* 

FMT 

X 

AVG 

BUFFER IN MAIN PGM 

OOOA 

0005 

POOOO 
PO 0 0 1 

0001 

0000 


OVFL 
A VG 

BZS 

0 

OVFL(l) 

0 


0006 

0007 

P0002 
PO 0 0 3 

0C09 
0 AOO 



ENQ 

ENA 

9 

0 

N WORDS 10 
Cl EAR A AND OVFL 

0008 

0009 

P0004 
PO 0 05 

68FB 
0 1 AO 



STA* 

SOV 

OVFL 

0 

TURN OFF OVERFLOW INDICATOI 

0010 

P0006 

P0007 

8A00 
7FF F 

X 

_X_ 

LOOP 

ADD 

X»Q 

ADD UP DATA 

0011 
0 01? 

P0008 
PO 009 

01B3 



SNO 

RAO'**- 

TEST-*~1 

nvFi 

TF OVFRFI OW 

0013 

POOOA 

nn n n Q 

AOOO 

7FFF 



AND 

=N$7FFF 


0014 
0 015 

POOOC 

POOOO 

0142 
ODF E 


TEST 

SQZ 

T MO 

AV-*-l 

-1 


V W X 

0016 

0017 

POOOE 

POOOF 

18F7 
E8F 0 


A V 

JMP* 

LDQ* 

LOOP 

OVFL 


0018 

0019 

POOlO 
PO 0 1 1 

OFCl 

0F61 



ALS 

LPS 

1 

1 


0020 

P0012 
PO 0 1 3 

3000 
0 0 0 A 



DVI 

=N10 


0021 

0022 

P0014 

ICEC 


* LEAVE 

JMP* 

ANSWEP 

(AVG) 

IM A AND PEMAINDER 

IN Q AND RETURN TO CALLER 

0023 





END 




4 AAAG QOaiP OVFL QQQQP LOOP OOiX^P— TES-T OOflCP 

AV OOOFP X 0007X 


O 
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0002 




ENT 

MOVE 






FXT 



0004 


0022 


EQU 

ZERO(S22) 


none; 

p n n n ri 

(1 0 II fi 

Mr»VF 

0 

0 


0006 

POOOl 

CUED 


LDA- 

$ED 

FIGURE OUT N WORDS 

OOny 

P0002 

7 


FI IP- 

<KF7 


0008 

POO 0 3 

9 0 (J 0 


SUB 

=N$44 

SUBTRACT OFF SIZE OF CONVR' 


P 0 0 0 ^ 

0 0 u. 4 





0009 



•if 



SO IT WONT GET MOVED 


ERIffiEI 



TPA 

0 


0011 

P0006 

C6F7 

movlh 

LDA- 

($F7) »0 

MOVE IT 

nm ? 

p 0 n n 7 

ft ft F f ) 


FTA- 

(iFm ,Q 


0013 

POOOB 

UDFE 


INO 

-1 


00 14 

poo 0 9 

f)1 41 



nnT-«— 1 


0015 

POOOA 

IBFB 


JMP<^ 

MOVLP 


00 1 ft 

POO OH 


X ni IT 

RAO + 




poonc 

7FFF 

X 




nni 7 

p 0 0 0 n 

FOF n 


1 no- 

SFD 

m ^ IciU [1 1 £ 1 • J 1 J atssHm 

0018 

POOOE 

OUOl 


INO 

1 


0019 

POO OF 

1 622 



(7FRn) ,0 

JUMP TO MAIN 


0020 END 









o 


0001 

0002 

POOOO 

n n n n 1 

000 1 
n i\ f\ ^ 


— WAW 

3SS 

GQWR-T 

SAVEQ(l) * SAVE I (1) »SAVEA(1) 

0001 

P0002 
PO 0 0 3 

0001 
00 01 

RUF 

8SS 

RUF ( 3 ) 

0004 
OOQC^ 

POO 06 
POOOC 

0006 
0 0 2Ei 

BUFl 

C T f-M 

BSS 

NUM 

BUFl (6) 
S2B 1 S2D 

00 06 

POOOD 

POOOE 

002D 
0 3 0 

T AH 

UUM 



POOOF 
POO 1 0 

0031 

0032 





pool 1 

POO 1 p 

0033 

0 034 





P0013 
P 0 0 1 4 

0035 

0036 





P0015 
POO 1 6 

0037 

0038 




00 0 7 

P0017 

0039 


ENT 

CONVRT 

0008 

0009 

P0018 
POO 1 9 

0000 

48E6 

CONVRT 

0 

STO* 

0 

SAVED 

0010 
0 n 1 1 

POOIA 
r» n 1 Li 

EOFF 

'I 8F 8 


LOQ- 

9Tn-**- 

I 

0012 
0013 

POOIC 
p n n 1 f) 

0842 

4 0 p~ p 


CLR 

STQ- 

Q 

T 

0014 

POOIE 

0122 


SAP 

POS 

Uu 1 o 
0018 
0017 

r U i 1 

POO 20 
P 0 0 ? 1 

U ly U 1 

0864 

EAEA 

pns 

i NU 

TCA 
1 DO* 

1 

A 

SIGNtO 

0018 

0019 

P0022 
PO 0 23 

48E8 
EBE A 


STQ* 

LDQ* 

BUFl+5 

TAB-*-0 

0020 

0021 

P0024 
PO 0 25 

48E1 

EOOO 


STQ* 
1 no 

BUFl 

~M$20 

0022 

P0026 

P0027 

0020 

48DF 


STQ* 

QIJF 1 + 1 

0023 

0024 

P0028 

P002^ 

48DF 

480F 


STQ* 

STQ* 

BUFl+2 

BUFl+3 

0025 

002^ 

P002A 

P002B 

48DF 

0842 

LOOP 

STQ* 

CLR 

BUFl+4 

Q 

0027 

002« 

P002C 

pnnpi’t 

0106 
3 0 0 0 


SAZ 

DVI 

OUT 
=N1 n 

002Q 

P002E 

P002F 

OOOA 

EAOE 


LDQ* 

TAB » 0 

0030 

0011 

P0030 
P0 031 

4905 
1)01- F 


STQ* 

RAO- 

BUF1»I 

I 

0032 

0033 

P0032 
P 0 0 3 3 

18FB 

40FF 

OUT 

JMP* 

STQ- 

LOOP 

I 

0034 

0035 

P0 034 
PO 0 35 

0C05 

caoo 

BACK 

ENQ 
1 DA* 

5 

RUFl *0 

0036 

0037 

P0036 

P0037 

OFCB 

ODFE 


ALS 
T NO 

8 

-1 

0038 

rm-^Q 

P0038 

POOl*^ 

8ACD 

69C9 


ADD* 

STA* 

BUFlfQ 
BUF T I 

0040 
00.4.1- 

P003A 

P0Q3B 

DOFF 
ODIE 


RAO- 

— INQ 

I 

-L 


o 
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V/ ■ 

00A3 

n n /. /. 

r* 1 / u >1 u 

P003D 

nn m c 

JL t 1 

1HK7 

c: u r 1 I'l r\M 



JMP* 

F 1 D 0 



BACK 

c/w/FO 

. r 

0045 

n r\ ^ 

P003F 

nn r\ /. n 

LL. O JL 1 7 * V 

C8C1 

h 0 f-' r 

LDA^ 
c; T A — 

SAVEI 

1 


V u ^ o 

0047 

' T' V 

PC 041 

nn n /. 'j 

CO 0 0 
0 0 n T 

LDA 

=XBUF 


004P 
n n /. Q 

PU043 

1CD4 

JMP^^’ 

FKin 

(CONVRT) 




BUFl 0006P SIGN OOOCP TAB 


OOOEP CONVRT 0018P POS 


0021P 



ADDRESSES WHERE 
PROGRAMS LOADED 


AVER AG 2392 


CONVRT 23B7 



MAIN 


236C 


2387 


MVFLAG 2391 


CONVRT 23CF 


TTY PRINTOUT 


* 


MI 

*p 


J 

*K, 113, P6 
J 

*ASSEM 
OPTIONS LX 
J 


*p 


J 

*L,8 

J 

*X 


+ 4263 
+ 4263 
J 


Answers 


MI 

*p 

J 

*UTOPlA 


E * 

CKDISK - ENTER CKD/ FOR HEADING 

ADH,15F9,7FFF/ 

95F8 

ADH,95F8,65/ 

965D 

ADH, 965D, 2/ 

965F 

ADH, 965F, lOOD/ 

A66C 

ADH,A66C,8/ 

A674 

ADH, A674, 12/ 

A686 

ADH,4,A686/ 

A68A 

ADH, A68A, 3/ 

A68D 
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Utopia was used to sum the hex numbers, to check out the answer. The sum is A 68 D ^0 = 
42637^0. Divide by IO^^q for a decimal answer of 4263, The remainder 7 was not considered 
when the answer was printed. Note that the numbers used did generate overflow in the sum, 
thereby checking out the average routine. (The average routine would work only for positive 
numbers. ) 


In analyzing and planning the move portion, the following simple method could be used with 
imaginary core addresses: 



By drawing a simple picture to move only 10 words, beginning at 1001 and showing the con- 
tents of $ED and $F7 (which will be used for indirect addressing) it can be determined that the 
program should subtract the contents of $F7 from $ED and use that answer, $A, for the index 
in Q. The store through $ED would be analyzed the same way: ($ED) + $A = $1014. By 

looking at the picture, one can see that Q shoiild go from $A to 1; hence, the skip out of the 
loop should be after the last move when Q equaled 1. 
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The actual addresses involved after loading were: 


23FB 
23 B7 
23AC 
2392 
236C 


MOVE 

AVERAG 

MAIN 

CONVRT 

MOVE 

AVERAG 

MAIN 


> 

< 

> 


second run: 
CONVRT not moved 


first rim 


00F7 236B 

OOED 23FA 


23FA 26 

-236B 15 

8 F 10 

-44 CONVRT 4B 
4B moved 


The total number of locations involved was 8 F^ 0 . Less CONVRT, left 4 B ^0 to move, 
indexed from 4 B ^0 (the last location in MOVE) through 1 (the first location in MAIN). 


Q was 


G-23 



Solution to the AVG Reentrant Problem (11.3,2) 


0001 



NAM 

AVG 


0002 




ENT 

AVG 


0003 


OOBB 


EQU 

AVOLA($BB), AVOLR($BA), ZERO($22), LPMASK($2) 



OOBA 







0022 







0002 





0004 

POOOO 

0000 

AVG 

0 

0 


0005 

POOOl 

0500 


IIN 



0006 

P0002 

54BB 


RTJ- 

(AVOLA) 


0007 

P0003 

0006 


NUM 

6 


0008 

P0004 

0400 


EIN 



0009 

P0005 

C8FA 


LDA* 

AVG 

SAVE RETURN ADDRESS 

0010 

P0006 

6103 


STA- 

3,1 


0011 

P0007 

0844 


CLR 

A 


0012 

P0008 

6104 


STA- 

4,1 

ZERO OVERFLOW CELL 

0013 

P0009 

FlOl 

ADQ- 

1,1 

LWA+1 IN Q 

0014 

POOOA 4105 


STQ- 

5,1 

SAVE IN VOLA+5 

0015 

POOOB 

OlAO 


SOV 

0 

TURN OFF OVERFLOW 

0016 

POOOC 

E4FF 

LOOP 

LDQ- 

(I) 

FWA IN Q 

0017 

POOOD 

8622 


ADD- 

(ZERO),Q 

ADD DATA TO A 

0018 

POOOE 

01B2 


SNO 

TEST-*-l 


0019 

POOOF 

D104 


RAO- 

4,1 

COUNT OVERFLOW 

0020 

POOlO 

AOll 

AND- 

LPMASK+15 

AND OUT SIGN BIT 

0021 

POOH 

ODOl 

TEST 

INQ 

1 

UPDATE ADDRESS 

0022 

P0012 

4522 


STQ- 

(ZERO), I 

SAVE NEXT ADDRESS 

0023 

P0013 

0852 


TCQ 

Q 

COMPLEMENT NEXT ADDRESS 

0024 

P0014 

F105 


ADQ- 

5,1 

ADD LWA+1 

0025 

P0015 

0141 


SQZ 

DV-*-l 

FINISHED WHEN MATCH 

0026 

P0016 

18F5 


JMP* 

LOOP 


0027 

P0017 

E104 

DV 

LDQ- 

4,1 

PICK UP OVERFLOW 

0028 

P0018 

OFCl 

ALS 

1 

SQUEEZE OUT SIGN BIT 

0029 

POOlO 

0F61 


LRS 

1 


0030 

POOIA 3101 

DIV 

DVI- 

1,1 

DIVIDE FOR AVERAGE 

0031 

POOIB 

6101 


STA- 

1,1 

RETURN ANSWER IN A 

0032 

POOIC 

4500 


STQ+ 

0,1 

RETURN REMAINDER IN Q 


POOID 

0000 





0033 

POOIE 

C103 

EXIT 

LDA- 

3,1 

RESCUE RETURN ADDRESS 

0034 

POOIF 

0500 


IIN 



0035 

P0020 

68DF 


STA* 

AVG 


0036 

P0021 

54BA 


RTJ- 

(AVOLR) 


0037 

P0022 

0400 


EIN 



0038 

P0023 

ICDC 


JMP* 

(AVG) 


0039 




END 





5 

LWA+1 






4 

OVERFLOW 






3 

RETURN 






2 

I 






1 

A (N WORDS) 






(D+o 

Q (FWA) 
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The following routine, NAM AVGTST, was used to check out the subroutine to see if it re- 
turned the correct answer. It only checks the answer and does not check the reentrancy. It 
asked AVG for an average of 9 words of a 10-word buffer X, and then punched the average 4 
and remainder 0. 

The method used to run the routine in the background, since VOLA is a protected routine, was: 

1, Assemble and load AVGTST and AVG under MSOS. Do not execute yet, 

2, Turn off protect switch on console, 

3, Turn off disk (to protect the system). 

4, Set P on the console to the beginning address of AVGTST and RUN, 

This method could be used to check out any routine in the background which links to system 
routines in protected core. If the system in core gets clobbered, the image on the disk is 
intact. 
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0001 




NAM 

AVGTST 

0002 




ENT 

X, BEGIN 

0003 




EXT* 

AVG 

0004 

POOOO 

0A09 

BEGIN 

ENA 

9 NUMBER OF WORDS 

0005 

POOOl 

EOOO 


LDQ 

=XX BUFFER ADDRESS 


P0002 

0011 p 




0006 

P0003 

5800 X 


RTJ 

AVG 


P0004 

7FFFX 




0007 

P0005 

6816 


STA* 

TEMP SAVE ANSWER 

0008 

P0006 

4816 


STQ* 

TEMP+1 SAVE REMAINDER 

0009 



XA 

WRITE 

3, XB-XA-1, TEMP-XA-1, 2, B, 0, 1, A, X 

0009 

P0007 

54F4 




0009 

P0008 

0501 




0009 

P0009 

0008 





POOOA 

0000 




0009 

POOOB 

0003 




0009 

POOOC 

0002 





POOOD 

0013 




0010 




EXIT 


0010 

POOOE 

54F4 




0010 

POOOF 

OAOO 




0011 

POOlO 

14EA 

XB 

JMP- 

($EA) 

0012 

POOH 

0000 

X 

NUM 

0,1, 2, 3,4, 5, 6, 7, 8, 9 


P0012 

0001 





POOH 

0002 





P0014 

0003 





pools 

0004 





P0016 

0005 





POOH 

0006 





P0018 

0007 





POO 19 

0008 





POOIA 

0009 




0013 

POOIB 

0002 

TEMP 

BSS 

TEMP (2) 

0014 




END 

BEGIN 


ANSWER: 4 
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After tes ting out AVG to see if it gives an answer, it is then necessary to check out its re- 
entrancy. In the following computer run, two programs (PGMA and PGMB) were setup, 
each to call AVG as a subroutine. Links and a flag were added to the routines for test pur- 
poses only, PGMA calls AVG and AVG begins its calculation. It then checks a flag and causes 
a pseudo interrupt of itself, and causes PGMB to begin its run. PGMB calls AVG, gets an 
answer, punches it, and returns control back to the location in AVG where the pseudo interrupt 
occurred. AVG completes its calculation for PGMA, returns to PGMA, and PGMA punches 
its answer and hangs. 

Again, the programs are loaded under MSOS. Then the protect switch and disk are turned off 
while they execute. 

This method could be used as a skeleton to check a routine's reentrancy. 

The coding for testing reentrancy is marked by brackets in the example. 
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0001 




NAM 

PGMA 


0002 




ENT 

pgmA 


0003 




EXT 

AVG 


0004 

POOOO 

0000 

PGMA 

0 

0 


0005 

POOOl 

OAOA 


ENA 

10 

10 NUMBERS 

0006 

P0002 

EOOO 


LDQ 

=XX 

BUFFER ADDRESS X 


P0003 

OOOF P 





0007 

P0004 

5400 X 


RTJ+ 

AVG 

compute Average 


P0005 

7FFFX 





0008 

P0006 

6813 


STA* 

ANS 


0009 

P0007 

54 f4 


RTJ- 

($F4) 

PUNCH ANSWER 

0010 

P0008 

0401 


NUM 

$0401 


0011 

P0009 

0000 


ADC 

0 


0012 

POOOA 

0000 


NUM 

0 


0013 

POOOB 

0003 


NUM 

$0003 


0014 

POOOC 

oooi 


NUM 

1 


0015 

POOOD 

00i9 P 


ADC 

ANS 


0016 

POOOE 

18FF 


NUM 

$18FF 

HANG 

0017 

POOOF 

0000 

X 

NUM 

0,l,2i3*4,5i6,7i8,9 



POOlO 

oool 






POOH 

0002 






P0012 

0003 






POOH 

0004 






POO 14 

0005 






P0015 

0006 






P0016 

0007 






P0017 

0008 






POOH 

0009 





0018 

POOlO 

0001 

ANS 

BSS 

ANS(1) 


0019 




END 

PGMA 




ANSWER: 4 






0001 




NAM 

AVG 

0002 




ENT 

AVG 

0003 




ENT 

FINI 

0004 




EXT 

PGMB 

0005 


OOBB 


EQU 

AVOLA($BB) 



OOBA 






0022 






0002 




0006 

POOOO 

0000 

AVG 

0 

0 

0007 

POOOl 

0500 


HN 


0008 

P0002 

54BB 


RTJ- 

(AVOLA) 

0009 

P0003 

0007 


NUM 

7 

0010 

P0004 

0400 


EIN 


0011 

P0005 

C8FA 


LDA* 

AVG 

0012 

P0006 

6103 


STA- 

3,1 

0013 

P0007 

0844 


CLR 

A 

0014 

P0008 

6014 


STA- 

4,1 

0015 

P0009 

FlOl 


ADQ- 

1,1 

0016 

POOOA 

4105 


STQ- 

5,1 

0017 

POOOB 

OlAO 


SOV 

0 

0018 

POOOC 

E4FF 

LOOP 

LDQ- 

(I) 

0019 



* 



0020 



* 



0021 

POOOD 

6106 


STA- 

6,1 


0022 

POOOE 

C820 


LDA* 

FLAG 


0023 

POOOF 

0115 


SAN 

C 


0024 

POOlO 

OAOl 


ENA 

1 

> 

0025 

POOH 

681D 


STA* 

FLAG 


0026 

POO 12 

C106 


LDA- 

6,1 


0027 

P0013 

1400 ;x 


JMP+ 

PGMB 



POOH 

7fff|x 




0028 



♦ 



0029 

P0015 

C106 

C 

LDA- 

6,1 

0030 

POOlO 

0000 

FINI 

0 

0 

0031 



♦ 



0032 



♦ 



0033 

POOH 

8622 


ADD- 

(ZERO),Q 

0034 

P0018 

01B2 


SNO 

TEST-*- 

•1 

0035 

POO 19 

D104 


RAO- 

4,1 

0036 

POOIA 

AOll 


AND- 

LPMASK+15 

0037 

POOIB 

ODOl 

TEST 

INQ 

1 

0038 

POOIC 

4522 


STQ- 

(ZERO), I 

0039 

POOID 

0852 


TCQ 

Q 

0040 

POO IE 

F105 


ADQ- 

5,1 

0041 

POOIF 

0141 


SQZ 

DV-*-l 

0042 

P0020 

18EB 


JMP* 

LOOP 

0043 

P0021 

E104 

DV 

LDQ- 

4,1 

0044 

P0022 

OFCl 


ALS 

1 

0045 

P0023 

0F61 


LRS 

1 

0046 

P0024 

3101 

DIV 

DVI- 

1,1 

0047 

P0025 

6101 


STA- 

1,1 

0048 

P0026 

4500 


STQ+ 

0,1 


P0027 

0000 




0049 

P0028 

C103 

EXIT 

LDA- 

3,1 

0050 

P0029 

0500 


HN 


0051 

P002A 

68D5 


STA* 

AVG 

0052 

P002B 

54BA 


RTJ- 

(AVOLR) 

0053 

P002C 

0400 


EIN 


0054 

P002D 

1CD2 


JMP* 

(AVG) 

0055 

P002E 

0001 


BZS 

FLAG(l) 

0056 




END 



ONE MORE WORD VOLATILE 
NEEDED 


FIRST OR SECOND CALL? 




RETURN AFTER INTERRUPT 


ANSWERS: 

3 

4 
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0001 




NAM 

PGMB 



0002 




ENT 

PGMB 



0003 




EXT 

AVG, FINI 


0004 

POOOO 

0000 

PGMB 

0 

0 



0005 

POOOl 

6817 


STA* 

SA+1 ^ 



0006 

0007 

P0002 

P0003 

4814 

COFF 


STQ* 

LDA- 

SQ+1 

' I 1 


SAVE REGISTERS 

0008 

P0004 

680F 


STA* 

SI+1 J 

1 


0009 

P0005 

0A08 


ENA 

8 


8 NUMBERS 

0010 

POOOO 

EOOO 


LDQ 

=xx 


BUFFER ADDRESS X 


P0007 

OOIB P 






0011 

P0008 

5400 X 


RTJ+ 

AVG 


COMPUTE AVERAGE 


P0009 

7FFFX 






0012 

POOOA 

6819 


STA* 

ANS 



0013 

POOOB 

54F4 


RTJ- 

($F4) 


PUNCH A^BWER 

0014 

POOOC 

0401 


NUM 

$0401 



0015 

POOOD 

0000 


ADC 

0 



0016 

POOOE 

0000 


NUM 

0 



0017 

POOOF 

0003 


NUM 

$0003 



0018 

POOlO 

0001 


NUM 

1 



0019 

POOH 

0023 P 


ADC 

ANS 



0020 

P0012 

COOO 

SI 

LDA 

=N0 ^ 




P0013 

0000 






0021 

0022 

P0014 

P0015 

60FF 

EOOO 

SQ 

STA- 

LDQ 

r 

=N0 

> 

RESTORE REGISTERS 


POOlO 

0000 






0023 

P0017 

COOOO 

SA 

LDA 

=N0 ^ 




P0018 

0000 






0024 

P0019 

1400 X 


JMP+ 

FINI ^ 


RETURN TO AVG 


POOIA 

7FFFX 



J 



0025 

POOIB 

0000 

X 

NUM 

0,1, 2, 5 

5,4, 5, 6, 7 



POOIC 

0001 







POOID 

0002 







POOIE 

0003 







POOIF 

0004 







P0020 

0005 







P0021 

0006 







P0022 

0007 






0026 

P0023 

0001 

ANS 

BSS 

ANS(l) 



0027 




END 


ANSWER: 3 
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Another possible solution would be: 



NAM 

AVG 


ENT 

AVG 


EQU 

AVOLA($BB), AVOLR($BA), ZERO($22) 


EQU 

LPMASK($2), ONEBIT($23) 

AVG 

0 

IIN 

0 


RTJ- 

(AVOLA) 


NUM 

EIN 

5 


LDA* 

AVG 


STA- 

3,1 


LDA- 

I 


EOR- 

ONEBIT+15 


STA- 

I 


CLR 

A 


STA- 

4,1 


LDQ- 

1,1 


INQ 

-1 

LOOP 

ADD- 

(i),Q 


SNO 

TEST-*-l 


RAO- 

4,1 


AND- 

LPMASK+15 

TEST 

SQZ 

DV-*-l 


INQ 

-1 


JMP* 

LOOP 

DV 

LDQ- 

4,1 


ALS 

1 


LRS 

1 

DIV 

DVI- 

1,1 


STA- 

1,1 


STQ+ 

0,1 

EXIT 

LDA- 

IIN 

3,1 


STA* 

AVG 


LDA- 

I 


AND- 

LPMASK+15 


STA- 

I 


RTJ- 

EIN 

(AVOLR) 


JMP* 

END 

(AVG) 


The indirect bit on the contents of I causes proper addressing to be used to add up the buffer. 
Only 15 bits of the address are used for the direct addressing used to access the other volatile 
locations. 
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SOLUTION TO THREAD PROBLEM. (11. 4. 3. 3) 
Solution: Never. 


The problem here is that the programmer thinks the request priority of 14 will override the 
rmming priority of 12, but this is not so. It is the driver’s priority which must be considered, 
and the slow-equipment drivers usually run at 10, So, since the request is threaded as 
highest priority (14) on the queue for the logical unit (TTY, 4) and will be processed when the 
driver gets to run at its priority (10), the write will never be done. This is because the 
running program is hung in a loop at priority 12, waiting for an event which cannot occur (the 
thread word becoming zero) because the loop at 12 is locking out the driver. 

Process programs usually run at 4, 5, and 6 (below the drivers); this would eliminate the 
problem in the example program. However, any looping like this at any priority is going to 
slow down a system by locking out lower priorities. For example, if many process programs 
were coded this way, they could almost completely lock out job processing (which runs at 0 
and 1). It would be much better to code the write as follows, if it must imi at 12: 


OK 

COMPL 


EQU ADISP($EA) 


RTJ- 

($F4) 

NUM 

$OCED 

ADC 

COMPL 

NUM 

0 

NUM 

$18FC 

NUM 

35 

ADC 

BUF 

SQP 

OK-*-l 

JMP 

REJ 

JMP- 

(ADISP) 


FWRITE,RP=14, CR=13 
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SOLUTION TO MMPGM PROBLEM. (11. 5. 7) 


Note that after the FWRITE is initiated (at P0017), the program return jumps to CORSUB and 
then schedules SYSPGM. CORSUB will rim at the calling program’s priority (4). Then, since 
SYSPGM is scheduled to run at 4 also, it will rot begin until MMPGM is finished. (This is 
perfectly legal, as long as SYSPGM does not need any of the data in MMPGM and does not 
store anything in MMPGM.) At POOIC a jump is then made to the dispatcher to await com- 
pletion of the 1/ O. This all looks very good. 

However, the 1/ O has been going on concurrently and the driver runs at a very high priority 
(usually 10). If by any chance it finishes the write and transfers control to the completion 
routine WROTE (atPOOlD)at priority 6 before theRTJ+ CORSUB and the schedule for SYSPGM 
are finished, the space MMPGM is in will be released. Surprise ! 

This is quite possible because other system programs at intermediate priorities (i. e. , 7 and 
9) could be locking out the MMPGM at 4, yet the driver at 10 would be plodding away at its 
write. Naturally the completion at 6 will be done (after the 7 and 8 are finished) before the 
priority drops back down to 4 to try to do the return jump to CORSUB and the schedule re- 
quest, which, of course, aren't there any more. 

The word on mass memory coding is: Be careful, and think! 
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A possible correction for the program would be: 



NAM 

MMPGM 


ENT 

MMPGM 


EXT* 

REQRE J, lOERR 


EXT 

CORSUB 


EXT 

SYSPGM 

ADISP 

EQU 

ADISP($EA) 

MMPGM 

NUM 

$C8FE 


STA* 

REL+2 


JMP* 

WRITE 

MSGBUF 

ALF 

*,MASS MEMORY EXAMPLE* 

WRITE 

FWRITE 

$FC, WROTE-*+l, MSGBUF-*+5, 10, A, 5, 6, 1, X 


SQP 

REQOK- *-l 


RTJ 

REQREJ 

REQOK 

RTJ+ 

CORSUB 


JMP- 

(ADISP) 

WROTE 

SQP 

2 


RTJ 

lOERR 


SCHDLE 

REL,4,X 


SQP 

2 


RTJ 

REQREJ 


SCHDLE 

(SYSPGM), 4,0 


SQP 

2 


RTJ 

REQREJ 


JMP- 

(ADISP) 

REL 

RELEAS 

0,T,0 


END 

MMPGM 


In this solution, if the completion routine is entered before the RTJ+ to CORSUB is finished, 
REL and SYSPGM will be put on the scheduler stack to be executed after the completion exit 
to the dispatcher allows MMPGM to be picked up from the interrupt stack. 

Another possible correction to the program, perhaps better, would be simply to change the 
completion priority in the FWRITE request from 6 to 3. That would insure that any priority 4 
work would be finished before the release is executed. However, this would cause the space 
MMPGM is in to be tied up until SYSPGM is finished, which was not the intent. 




APPENDIX H 

o 
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o 


1 


o 

0001 *P 

0002 *ASSEM 

********up* ******* 


1700 

ADDRESSING EXAMPLES 
ASSEMBLED UNDER MSOS 2. 0 
OCT. 1968 


0003 POOOO 0000 NAM L 

5|c*******QP* ******* 

******* *UP******** 


0004 

POOOl 

0000 


NAM 

DAN 




0005 


0000 


ORG 

0 

SET ABSOLUTE ADDRESS 



0006 

0000 

OBOO 


NOP 





0007 

0001 

7FFF X 

LOWCOR 

0 

DPNDNT 

EXTERNAL SYMBOL 



0008 


OOFE 


ORG 

$FE 

RE-SET ABSOLUTE ADDRESS 


0009 

OOFE OOBD P 

TEMPI 

0 

ANYWHR 




0010 

OOFF 0000 

INDEX2 

0 

0 




0011 

0100 

0000 

ABSRNG 

0 

0 




0012 


0002 P 


ORG* 





0013 

P0002 

0000 

RE LOW 

0 

0 




0014 



* 



1700 ASSEMBLY EXAMPLES 



0015 



* 



********STORAGE REFERENCE******** 

0016 



* 



**GROUP 1** 



0017 



* 

EVALUATION OF ADDRESS FIELD RESULTS IN DESIRED OPERAND ADDRESS 

0018 



* 

*ABSOLUTE* 




0019 



*LABEL* 

*OPN* 

*ADDRESS* 

*DESCRIPTION* 

*BA* 

*EFA* 

0020 

P0003 

COFE 


LDA- 

TEMPI 

NO INDEXING 

TEMPI 

TEMPI 

0021 

P0004 

C2FE 


LDA- 

TEMPI, Q 

Q INDEXING 

TEMPI 

TEMP1+(Q) 

0022 

P0005 

CIFE 


LDA- 

TEMPI, I 

I INDEXING 

TEMPI 

TEMP1+(00FF) 

0023 

P0006 

C3FE 


LDA- 

TEMPI, B 

DOUBLE INDEXING 

TEMPI 

temph<q>koofI 

0024 

P0007 

C020 


LDA- 

$20 

NUMERIC HEX EXAMPLE 

20 HEX 

20 HEX 

0025 

P0008 

COM 


LDA- 

20 

NUMERIC DEC EXAMPLE 

20 HEX 

20 DEC 

5(: *>(: **** p ^ ******* * 







0026 

P0009 

COOO 


LDA- 

ABSRNG 

-DELTA OUT OF RANGE 



X=****>|C*>KPL******** 







0027 

POOOA 

C002 


LDA- 

RELOW 

PROGRAM RELOCATABLE ADDRESS 


^ ^ ^ ^ ^ ^ ^ T 5|< Sjc ^ jjC 5^ >|< 







0028 

POOOB 

COlO 


LDA- 

BLOCK6 

DATA RELOCATABLE ADDRESS 


Jj ^jC5)C5|C3|<5|CS|<?|C5|< 







0029 

POOOC 

COOO 


LDA- 

BLOCK3 

COMMON RELOCATABLE 



********Uj) ******** 







0030 

POOOD 

COOO 


LDA- 

UNDEFINED UNDEFINED SYMBOL 




\ 



H-2 


0032 



=t= 

♦RELATIVE* 





0033 



*LABEL* 

♦OPN* 

♦ADDRESS* 

♦DESCRIPTION* 

*BA* 

*EFA* 

0034 

POOOE 

C822 

BAKREL 

LDA* 

RELADR 

DELTA=RELADR+(-*) 

RELADR 

RELADR 

0035 

POOOF 

CA21 


LDA* 

RELADR,Q 

DELTA=RELADR+(-*) 

RELADR 

RELADR+(Q) 

0036 

POOlO 

CB20 


LDA* 

RELADR, B 

DE LT A= RE LADR+ (- * ) 

RELADR 

RELADR+(Q)+(00FF) 

0037 

POOH 

C8FC 


LDA* 

BAKREL 

DELTA=BAKREL+(-*) 

BAKREL 

BAKREL 

0038 

P0012 

C8FD 


LDA* 

*-2 

DELTA+*-2+(-*) 

*-2 

*-2 

0039 

P0013 

181D 


JMP* 

RELADR 

JUMP ADDRESS=EFA 

RELADR 

RELADR 

+ * * ♦ ♦ ♦ L + : 

<'****** 







0040 

P0014 

C017 


LDA* 

TAGLRM-BAKREL 

FORM RELATIVE ADDRESS 


********RL******** 







0041 

P0015 

COlO 


LDA* 

$10 

ABSOLUTE ADDRESS 



********RL******** 







0042 

POOlO 

COOOO 


LDA* 

ABSRNG 

ABSOLUTE ADDRESS 



3|C 5|C * ♦ + * >(c :(< P ^ : 

<cHt***** 







0043 

POOH 

C0A6 


LDA* 

ANYWHR 

DELTA OUT OF RANGE 


0045 



* 


♦♦♦♦CONTINUATION OF STORAGE REFERENCE**** 

0046 



* 



****QJ^OUP 1**** 



0047 



* *LONG RELATIVE 

* 




0048 



♦LABEL* 

♦OPN 

♦ADDRESS* 

♦DESCRIPTION* 

♦BA* 

♦EFA* 

0049 

P0018 

C800 


LDA 

RELADR 

M=RELADR+(-*.+l) 

RELADR 

RELADR 


P0019 

0017 







0050 

POOIA 

C800 


LDA 

ANYWHR 

M=16 BIT REL ADDRESS ANYWHR 

ANYWHR 


POOIB 

00A2 







0051 

POOIC 

CAOO 


LDA 

ANYWHR, Q 

Q INDEXING 

ANYWHR 

ANYWHR+(Q) 


POOID 

OOAO 







0052 

POOIE 

5800 


RTJ 

ANYWHR 

JUMP ADDRESS=EFA 

ANYWHR 

ANYWHR 


POOIF 

009E 







0053 

P0020 

C400 


LDA 

TEMPI 

ABSOLUTE ADDRESS, ASSEMBLED AS 

STORAGE 


P0021 

OOFE 







0054 

P0022 

C400 


LDA 

$500 

ASSEMBLED AS STORAGE MODE 



P0023 

0500 







0055 

P0024 

C800 


LDA* 

* 

WORD ONE OF LONG 

RELATIVE 


0056 

P0025 

0000 

TAGLRM 

0 

0 

WORD TWO OF LONG 

RELATIVE 



O 


! 



H-3 


o 



0058 



* 

♦STORAGE* 





0059 



♦LABEL* 

♦OPN* 

♦ADDRESS* 

♦DESCRIPTION* 

♦BA* 

♦EFA* 

0060 

P0026 

C400 

BACIND 

LDA+ 

ANYWHR 

2ND WORD=ANYWHR 

ANYWHR 

ANYWHR 


P0027 

OOBD P 







0061 

P0028 

C600 


LDA+ 

ANYWHR, Q 

Q INDEXING 

ANYWHR 

ANYWHR+(Q) 


P0029 

OOBD P 







0062 

P002A 

C700 

MEMADR 

LDA+ 

$500, B 

NUMERIC EXAMPLE 

$500 

$500+(Q)+(00FF) 


P002B 

0500 







0063 

P002C 

C400 


LDA- 

(0) 

WORD ONE On STORAGE 

MODE 


0064 

P002D 

0000 

TAGSM 

0 

0 

WORD TWO OF STORAGE 

MODE 


0065 

P002E 

5400 


RTJ+ 

ANYWHR 

JUMP ADDRESS=EFA 

ANYWHR 

ANYWHR 


P002F 

OOBD P 







0067 



* 






0068 



* 






0069 



* 

EVALUATION OF ADDRESS FIELD RESULTS IN DESIRED ADDRESS OF OPERAND ADDRESS 

0070 



* 

♦INDIRECT* 





0071 



♦LABEL* 

♦OPN* 

♦ADDRESS* 

♦DESCRIPTION* 

♦BA* 

♦EFA* 

0072 

P0030 

C4FE 

RELADR 

LDA- 

(TEMPI) 

DELTA=TEMP1 

(TEMPI) 

(TEMPI) 

0073 



* 

LDA- 

(TEMPI), Q 

DELTA=TEMP1 

(TEMPI) 

(TEMP1)+(Q) 

0074 



* 

LDA- 

(TEMPI), B 

DELTA=TEMP1 

(TEMPI) 

(TEMP1)+(Q)+(00FF) 

0075 

P0031 

C4FF 


LDA- 

(TEMPl+1) 

DELTA=TEMP1+1 

(TEMPl+1) 

(TEMPl+1) 

0076 

P0032 

C420 


LDA- 

($20) 

DELTA=$20 

($20) 

($20) 

0077 

P0033 

14FE 


JMP- 

(TEMPI) 

JUMP ADDRESS=EFA 

(TEMPI) 

ANYWHR 

0079 



♦ 

♦STORAGE INDIRECT* 




0080 



♦LABEL* 

♦OPN* 

♦ADDRESS* 

♦DESCRIPTION* 

♦BA* 

♦EFA* 

0081 

P0034 

C600 

RE LIND 

LDA+ 

(BACIND+1),Q 

2ND WORD= BACIND+1 

(BACIND+1) 

ANYWHR+(Q) 


P0035 

8027 P 







0082 

P0036 

C700 


LDA+ 

(MEMADR+1), B 

2ND WORD=MEMADR+l 

(MEMADR+1) 

$500+(Q)+(00FF) 


P0037 

802B P 







0083 

P0038 

C400 


LDA+ 

($700) 

NUMERIC EXAMPLE 

($700) 

($700) 


P0039 

8700 







0084 

P003A 

5400 


RTJ+ 

(BACIND+1) 

JUMP ADDRESS=EFA 

(BACIND+1) 

ANYWHR 


P003B 

8027 P 







0086 



♦ 

♦RELATIVE 

INDIRECT* 




0087 



♦LABEL* 

♦OPN 

♦ADDRESS* 

♦DESCRIPTION* 

♦BA* 

♦EFA* 

0088 

P003C 

CCEA 


LDA* 

(BACIND+1) 

DELTA=BACIND+l+(-*) 

(BACIND+1) 

ANYWHR 

0089 

POO 3D 

CDED 


LDA* 

(MEMADR+1) , I 

DELTA=MEMADR+l+(-*) 

(MEMADR+1) 

$500+(00FF) 

0090 

P003F 

CFF6 


LDA* 

(RELIND+1),B 

DELTA=RELIND+l+(-*) 

(RELIND+1) ANYWHR+(Q)+(00FF) 



H-4 


0092 



* *LONG RELATIVE 

INDIRECT* 



0093 



*LABEL* 

*OPN* 

*ADDRESS* 

*DESCRIPTION* *BA* 

*EFA* 

0094 

P003F 

P0040 

CCOO 

FFE6 


LDA 

(BACIND+1) 

M=BACKIND+(-*)+l (BACIND+1) 

ANYWHR 

0095 

P0041 

P0042 

CEOO 

007B 


LDA 

(ANYWHR),Q 

16 BIT REL ADDRESS (ANYWHR) 

(ANYWHR)+(Q) 

0096 

P0043 

C400 


LDA 

($700) 

ASSEMBLED AS STORAGE INDIRECT 



P0044 

8700 






0098 



* 


****CONTINUATION OF STORAGE REFERENCE**** 


0099 



* 





0100 



* 

EVALUATION OF ADDRESS FIELD RESULTS IN DESIRED OPERAND 

0101 



* 


N = NUMERIC 

X = ADDRESS A = ALPHANUMERIC 


0103 



* 

* CONSTANT* 




0104 



*LABEL* 

*OPN* 

*ADDRESS* 

*DE SCRIPT ION* *BA* 

*EFA* 

0105 

P0045 

COOO 


LDA 

=N1000 

NUMERIC EXAMPLE DEC P+1 

P+1 


P0046 

03E8 






0106 

P0047 

COOO 


LDA 

=N$1000 

NUMERIC EXAMPLE HEX P+1 

P+1 


P0048 

1000 






0107 

P0049 

COOO 


LDA 

=N-$1000 

NUMERIC EXAMPLE NEG P+1 

P+1 


P004A 

EFFF 






0108 

P004B 

COOO 


LDA 

=XBACIND 

ADDRESS EXAMPLE P+1 

P+1 


P004C 

0026 P 






0109 

P004D 

COOO 


LDA 

=X-BACIND 

ADDRESS EXAMPLE NEG P+1 

P+1 


P004E 

7FD9-P 






0110 

P004F 

COOO 


LDA 

=ABC 

ALPHA EXAMPLE P+1 

P+1 


P0050 

4243 






0111 

P0051 

C200 


LDA 

=N$1000,Q 

RA=(P+1) *INDEXING* $1000 

OPERAND 


POO 52 

1000 






0112 

P0053 

COOO 


LDA- 

0 

WORD ONE OF CONSTANT MODE 


0113 

POO 54 

0000 

TAGCM 

0 

0 

WORD TWO OF CONSTANT 


5f: ***>!< >l« gX* 






0114 

P0055 

6400 


STA 

=N$0 

ASSEMBLER WILL NOT ALLOW 



P0056 

0000 






0115 

POO 57 

COOO 


LDA 

=X-4 

NUMERIC WITH ADDRESS INDICATOR 



P0058 

7FFB 






0116 

POO 59 

COOO 


LDA 

=X(BACIND) 

SET INDIRECT BIT ON ADDRESS VALUE 



P005A 

8026 P 









H-5 


o 



0118 * 


0119 



* 

EVALUATION OF ADDRESS 

0120 



*LABEL* 

*OPN* 

*ADDRESS* 

0121 

P005B 

0847 


CLR 

A,Q,M 

0122 

P005C 

080C 


TRM 

A 

0123 

P005D 

0811 


TRQ 

M 

0124 

P005E 

0823 


TRA 

Q,M 

0125 

P005F 

081C 


TRB 

A 

0120 

P0060 

0801 


SET 

M 

0127 

POO 61 

0854 


TCQ 

A 

0128 

POO 62 

0834 


AAQ 

A 

0129 

P0063 

086A 


EAM 

Q 

0130 

P0064 

08B2 


LAQ 

Q 

0131 

POO 6 5 

08F4 


CAQ 

A 

*****;) 

4 +JPX* 

******* 




0132 

P0066 

0820 


TRA 

X 

0134 



* 



0135 



* 

EVALUATION OF ADDRESS 

0136 



*LABEL* 

*OPN* 

♦ADDRESS* 

0137 

P0067 

0105 


SAZ 

5 

0138 

P0068 

0156 


SQN 

SKIPAD-*-! 

0139 

P0069 

0115 


SAN 

SKIPAD 

<i'*******p^* 

******* 




0140 

P006A 

0120 


SAP 

$10 

********p^* 

******* 




0141 

P006B 

013A 


SAM 

-5 

0143 



* 



0144 



* 

EVALUATION OF ADDRESS 

0145 



*LABEL* 

*OPN* 

♦ADDRESS* 

0146 

P006C 

OFAC 


QLS 

12 

0147 

P006D 

0FD2 


ALS 

$12 

0148 

P006E 

0F7F 


LRS 

31 

0149 

P006F 

OBOA 

SKIPAD 

NOP 

10 

0150 

P0070 

0F53 


ARS 

$33 

0151 

P0071 

0F5F 


ARS 

DELTA 

0152 

P0072 

OFDA 


ALS 

-5 


*******REGISTER transfer******** 

FIELD RESULTS IN DESIRED DESTINATION REGISTER 
*DESCRIPTION* 

CLEAR A Q AND M REGISTERS 

TRANSFER M TO A 

TRANSFER Q TO M 

TRANSFER A TO Q AND M 

TRANSFER INCLUSIVE OR OF M Q TO A 

SET M TO ALL ONES 

TRANSFER THE COMPLEMENT OF Q TO A 

TRANSFER SUM OF A Q TO A 

TRANSFER EXCLUSIVE OR OF A M TO Q 

TRANSFER LOGICAL AND OF A Q TO Q 

TRANSFER COMPLEMENT OF LOGICAL AND OF A Q TO A 

ILLEGAL DESTINATION REGISTER 


***Ho|<*>|:*gJ^JP3** ****** 

FIELD RESULTS IN DESIRED SKIP COUNT 
*DESCRIPTION* 

IF(A) IS 0 SKIP FORWARD 6 PLACES ++1+SKIPCOUNT 
IF(Q) NEG SKIP TO SKIPAD (NON ABSOLUTE METHOD) 
SKIP COUNT OUT OF RANGE 

SKIP COUNT OUT OF RANGE 

NEG SKIP COUNT 


******** g pj j jp p g ******* * 

FIELD RESULTS IN DESIRED SHIFT COUNT 
*DESCRIPTION* 

LEFT SHIFT Q 12 DECIMAL POSITIONS 
LEFT SHIFT A 12 HEX POSITIONS 

RIGHT SHIFT Q/A 31 DECIMAL POSITIONS (31 = MAX) 

WAIT XX MICROSECONDS 

SHIFT COUNT GREATER THAN $31 

SYMBOLIC SHIFT COUNT 

NEG SHIFT COUNT 



H-6 


0154 * 

0155 * EVALUATION OF ADDRESS FIELD 


0156 

*LABEL* 

*OPN* 

*ADDRESS* 

0157 P0073 0A75 


ENA 

$75 

0158 P0074 OCEA 


ENQ 

-$15 

0159 P0075 0A7F 

jfc 3|< ^ 5|< ^ j|c 5|< 5)c + 


ENA 

127 

0160 P0076 0A80 

4: 5|< 3(c jf: 5|< ^ 4: Jfc 5(5 5|< 5(c s(c 


ENA 

128 

0161 P0077 OAOl 


ENA 

257 

0162 P0078 OAIF 


ENA 

DELTA 

0163 P0079 OAEO 

5(: 5(: >(: :(e 5|c 5|c 5(t >(::(: 5|c 5|< 


ENA 

-DELTA 

0164 P007A OAFF 

5(e 5|c 5(: 5(: :(c >(c 5|c g ^ :(e :(: 5(c>|< 5|e 5(: 5(: 


ENA 

INDEX2 

0165 P007B 0A02 

**’H*****gX* ******* 


ENA 

RE LOW 

0166 P007C OAIO 

5(c 5|e 5|s sf: 5(: % 5(c 5(: JJ^5(: >(: :)c :)e 5(« >(: 5|c 


ENA 

BLOCK6 

0167 P007D OAOO 


ENA 

BLOCK3 

0168 P007E 09FE 


INA 

-1 

0169 P007F 0D25 


INQ 

$25 

0170 P0080 0206 

5(< 5|c >(: 5|c 5|< 5(c 5|c 5(: g ^ >(: 5|C 5)C 5(: >(: 5)c 5(c 


INP 

REJCTA-*-! 

0171 P0081 0287 


INP 

REJCTA 

0172 P0082 0400 


EIN 

0 

0173 P0083 0500 


HN 

0 

0174 P0084 0E04 


EXI 

4 

0175 P0085 0600 


SPB 

0 

0176 P0086 0700 


CPB 

0 

0177 P0087 0000 

REJCTA 

SLS 

0 

0178 OOIF 


EQU 

DELTA($1F) 


RESULTS IN VARIOUS PORTIONS OF ASSEMBLED INSTS 
^DESCRIPTION* 

ENTER A WITH VALUE SPECIFIED IN ADDRESS FIELD 

NEC EXAMPLE 

DEC EXAMPLE (MAX VALUE) 

NEC. NUMERIC VALUE 

OUT OF RANGE NUMERIC VALUE 
POS. SYMBOLIC VALUE 
NEG. SYMBOLIC VALUE 

NEG. SYMBOLIC VALUE 

PROGRAM RELOCATABLE VALUE 

DATA RELOCATABLE VALUE 

COMMON RELOCATABLE VALUE 

INCREASE A BY THE VALUE SPECIFIED IN ADDRESS FD 
INCREASE Q 

INPUT TO A REJECT ADDRESS- P+l+DELTA 

DELT OUT OF RANGE 
ENABLE INTERRUPT SYSTEM 
INHIBIT INTERRUPT SYSTEM 

EXIT INTERRUPT ADDRESS FIELD = INTERRUPT 
SET PROTECT BIT (Q) = ADDRESS 
CLEAR PROTECT BIT (Q) = ADDRESS 
STOP IF STOP KEY SET 

EQUATE SYMBOLIC VALUE FOR ABOVE USE 





H-7 


o 



0180 

0181 

0182 

0183 

0184 

0185 

0186 


0187 


* ********QLASS 2 PSEUDOS******** 

* *ADC* ADDRESS CONSTANT PSEUDO 

* THE ADDRESS EXPRESSIONS IN SUBFIELD ARE ASSEMBLED INTO CONSECUTIVE CELL 

* LOCATIONS. IF ADDRESS EXPRESSION IS ENCLOSED IN PARENTHESIS THE ADDRESS 

* BECOMES INDIRECT. 

*LABEL* *OPN* *ADDRESS* 

P0088 0030 P ADLIST ADC RELADR, BACIND, (MEMADR), -RELADR 

P0089 0026 P 
P008A 802A P 
P008B 7FCF-P 

P008C 7FF0 0 -$F TREATED AS ONE WORD ADC 


0189 

0190 

0191 

0192 

0193 P008D 1000 
P008E 03E8 
P008F EFFF 
P0090 FF9B 


♦ *NUM* NUMERIC CONSTANT PSEUDO 

♦ THE NUMERIC EXPRESSIONS IN SUBFIELD ARE ASSEMBLED INTO CONSECUTIVE CELL 

♦ LOCATIONS. THE CONSTANTS CAN BE EITHER DECIMAL OR HEX VALUES. 

*LABEL* *OPN* *ADDRESS* 

CONLST NUM $1000, 1000, -$1000, -100 


0195 

0196 

0197 

0198 


* *ALF* ALPHANUMERIC MESSAGE PSEUDO 

* THE ADDRESS FIELD CONTAINS THE NUMBER OF CELLS TO BE RESERVED FOR THE 

* REMAINING CHARACTERS IN FIELD. 

*LABEL* *OPN* *ADDRESS* 



H-8 


0200 

0201 

0202 

0203 

0204 

0205 


***** CONTINUATION OF CLASS 2 PSEUDOS***** 

* *ENT* ENTRY PSEUDO 

* THIS PSEUDO WILL CAUSE A BINARY OUTPUT WHICH WILL ALLOW EXTERNAL 

* SYMBOLS OF OTHER PROGRAMS TO BE DEFINED AT *LOAD TIME* 

* *OPN* *ADDRESS* 

ENT START, BACIND 


0207 

0208 

0209 

0210 
0211 
0212 


0213 

P0091 

5400 

X 


P0092 

0001 

X 

0214 

P0093 

OBOO 


0215 

P0094 

5400 

X 


P0095 

0092 

X 

0216 

P0096 

OBOO 


0217 

P0097 

5401 


0218 

P0098 

OBOO 


>k**>k*>io|c*ex******** 

0219 

P0099 

5400 

X 

0220 

P009A 

OBOO 


5): He**: 

H:***EX******** 

0221 

P009B 

5000 

X 


*EXT* EXTERNAL PSEUDO 

THIS PSEUDO WILL ALLOW SYMBOLIC VALUES UNDEFINED IN THE INDEPENDENT 
PROGRAM TO BE MATCHED WITH ENTRY VALUES AND DEFINED AT LOAD TIME. 


*OPN* 

*ADDRESS* 

*DESCRIPTION* 

EXT 

DPNDNT 

DPNDNT WILL BE MATCHED WITH ENTRY POINT 
AT LOAD TIME. 

RTJ 

DPNDNT 

DPNDNT IS UNDEFINED IN CURRENT ROUTINE 

NOP 



RTJ 

DPNDNT 

ASSEMBLED AS STORAGE 

NOP 



RTJ- 

NOP 

(LOWCOR) 

INDIRECT LINKING 

RTJ* 

NOP 

DPNDNT 


RTJ- 

DPNDNT 



f 



H-9 





0223 

0224 

0225 

0226 

0227 

0228 


* 

* 

* 

* 

♦ 


0100 
009C P 


****CLASS 3 PSEUDOS**** 

*EQU* EQUATE PSEUDO 

TfflS PSEUDO WILL CAUSE A SYMBOLIC VALUE TO BE EQUATED TO ANOTHER 
SYMBOLIC VALUE OR TO A NUMERIC VALUE AND PLACED IN SYMBOL TABLE. 
*OPN* *ADDRESS* 

EQU START ($100), HERE (*) 


0230 

0231 

0232 

0233 

0234 

0235 P009C OBOO 

0236 P009D 0010 

0237 POOAD OBOO 


* *BSS* BLOCK STORE PSEUDO 

* THIS PSEUDO WILL CAUSE A RESERVATION OF THE NUMBER OF CELLS SPECIFIED 
BY THE VALUE IN THE ADDRESS FIELD. THE CONTENTS OF THESE CELLS WILL BE 


UNCHANGED AT LOAD TIME. 




*LABEL* *OPN* 

*ADDRESS* 

*DESCRIPTION* 



NOP 

0 

INDICATOR TO 

SHOW 

CURRENT ADDRESS 

BSS 

BLOCK8($10) 




NOP 

0 

INDICATOR TO 

SHOW 

CURRENT ADDRESS 


0239 

0240 

0241 

0242 POOAE OBOO 

0243 POOAF 0005 

0244 P00B4 OBOO 


* *BZS* 

* 

*LABEL* 

BLOCK2 


BLOCK ZERO STORE PSEUDO 
SAME AS BSS EXCEPT CELLS 
*OPN* *ADDRESS* 

NOP 0 

BZS BLOCK9($5) 

NOP 0 


WILL BE SET TO ZERO AT LOAD TIME. 
*DESCRIPTION* 

INDICATOR TO SHOW CURRENT ADDRESS 
INDICATOR TO SHOW CURRENT ADDRESS 


0246 

0247 

0248 

0249 

0250 

0251 


* 

* 

* 

* 

* 

0000 c 

0030 C 


*COM* COMMON STORAGE PSEUDO 

THE NAME OF THE BLOCKS AND THE SIZE ARE DEFINED IN THE ADDRESS FIELD 
OF PSEUDO. THE STORAGE AREA WILL BE ASSIGNED TO THE AREA OF THE 
LOADER AT LOAD TIME. 

*OPN* *ADDRESS* *DESCRIPTION* 

COM BLOCK3($30),BLOCK4($100) BLOCK4=BLOCK3+$30 


0253 * 

0254 * 

0255 * 

0256 * 

0257 0000 D 
0010 D 

0258 P00B5 OBOO 


*DAT* DATA STORAGE PSEUDO 

THE METHOD OF RESERVATION IS THE SAME AS COM EXCEPT THE AREA CAN 
BE PRESET. 

*OPN* *ADDRESS* *DESCRIPTION* 

DAT BLOCK5($10),BLOCK6($20*$20) 

NOP 0 INDICATOR TO SHOW CURRENT ADDRESS 



OT-H 


0260 * METHODS OF PRESETTING DATA IN DATA AREA 

0261 * ALSO SHOWN IS ILLEGAL USE OF COMM AREA 


0263 


0000 

D 

0264 

DOOOO 

0088 

P 


DOOOl 

002A 

P 


D0002 

008D 

P 


D0003 

009C 

P 

*5|<******ud* ******* 


D0004 

8000 


0265 

D0005 

0001 



D0006 

0002 



D0007 

0003 



D0008 

0004 



D0009 

0005 


0266 


00B6 

P 

0267 

P00B6 

OBOO 


^ 5|< 5|C 5|< 3|o|< ^ ^ 

0268 


0000 


0269 

P00B7 

0001 



P00B8 

0002 



P00B9 

0003 



POOBA 

0004 



POOBB 

0005 



ORG BLOCKS PRESET TO DATA AREA 

ADC ADLIST, MEMADR, CONLST, HERE, (WORD2A) 


NUM 1,2, 3, 4, 5 


ORG* 0 RESET TO NORMAL COUNTER 

NOP 0 INDICATOR TO SHOW CURRENT ADDRESS 


ORG BLOCKS SET COUNTER TO COMMON AREA 

NUM 1,2, 3, 4, 5 ILLEGAL TO SET DATA IN COMMON 


0271 

0272 

0273 

0274 

0275 

0276 


* ********QLAgg pgguDOS******** 

* NAM NAME PSEUDO 

* THE NUMERIC VALUE IN LABEL FIELD WILL SET PROGRAM COUNTER TO AN 

* ABSOLUTE VALUE. THE ADDRESS FIELD CONTAINS THE PROGRAM NAME. 

* ONLY ONE NAM ALLOWED PER PROGRAM. NAM IS USED TO IDENTIFY INDE- 

* PENDENT PROGRAMS. 


0278 * ORG PROGRAM COUNTER CONTROL PSEUDO 

0279 * COUNTER. IF NUMERIC IS USED PROGRAM WILL BE ASSEMBLED ABSOLUTE. 



o 




TT-H 





0281 

0282 

0283 

0284 

0285 POOBC OBOO 


* ORG* RETURN PROGRAM COUNTER PSEUDO 

* USED TO RETURN COUNTER TO NORMAL VALUE 

* *OPN* *ADDRESS* *DESCRIPTION* 

ORG* 

NOP 0 INDICATOR TO SHOW CURRENT ADDRESS 


0287 OOBD P 


EQU ANYWHR(*) 


0289 

0290 

0291 

0292 

0293 

0294 

0295 


* *END* END PSEUDO 

* MUST BE LAST CARD OF EACH PROGRAM, SYMBOL IN ADDRESS FIELD IS THE 


* 

ADDRESS 

CONTROL WILL BE TRANSFERRED TO AT LOAD TIME. 

* 

* 

*OPN* 

*ADDRESS* 

* 

END 

START 


I 

OOFF 

LOWCOR 

0001 

TEMPI 

OOFE 

INDEX2 

OOFF 

ABSRNG 

0100 

RE LOW 

0002P 

BARREL 

OOOEP 

TAGLRM 

0025P 

BACIND 

0026P 

MEMADR 

002AP 

TAGSM 

0002DP 

RELADR 

0030P 

RELIND 

0034P 

TAGCM 

0054P 

SKIPAD 

006FP 

REJCTA 

0087P 

DELTA 

OOIF 

ADLIST 

0088P 

CONLST 

008DP 

START 

0100 

HERE 

009CP 

BLOCKS 

009DP 

BLOCK9 

OOAFP 

BLOCK3 

OOOOC 

BLOCK4 

0030C 

BLOCK5 

OOOOD 

BLOCK6 

OOlOD 

ANYWHR 

OOBDP 

DPNDNT 

0095X 




030 ERRORS 



c 





APPENDIX I 


r 





APPENDIX I 


COMMUNICATION REGION 

The communication region is the area of core below FF^ 0 . It can be addressed directly by a 
one-word instruction. Contents are defined by the following table. All locations are pro- 
tected except as noted, EQU names are noted also. 



X Location 

Contents 

HEX Equivalent 


0 &1 

Reserved for the system 


LPMASK 

► 2 

0000000000000000 

0 


a 

0000000000000001 

1 


4 

0000000000000011 

3 


5 

0000000000000111 

7 




OOOOOOOOOpOOlllL- 

F 


7 

oooooooooooLim 

IF 



ooooooooooiiiin 

3F 


9 

0000000001111111 

7F 


A- 

0000000011111111 

FF 


B 

0000000111111111 

IFF 


G 

0000001111111111 

3FF 


D 

0000011111111111 

7FF 


E 

0000111111111111 

FFF 


E 

0001111111111111 

IFFF 


10, 

0011111111111111 

3FFF 


11 

..__oiiiiiiiiiiimi 

7FFF 

NZERO 

^12 

^iiiimiiiimi 

FFFF 


is'" 


FFFE 


14 

1111111111111100 

FFFC 


15 

1111111111111000 

FFF 8 


16 

1111111111110000 

FFFO 


17 

1111111111100000 

FFEO 


18 

1111111111000000 

FFCO 


19 

1111111110000000 

FF80 


lA 

1111111100000000 

FFOO 


IB 

1111111000000000 

FEOO 


1C 

1111110000000000 

FCOO 


ID 

1111100000000000 

F800 


IE 

1111000000000000 

FOOO 


IF 

1110000000000000 

EOOO 


20 

1100000000000000 

COOO 


21 

1000000000000000 

8000 

ZERO 

► 22 

0000000000000000 

0000 


I-l 



Location 


Contents 


HEX Equivalent 


ONE BIT 

► 23 

0000000000000001 

0001 


24 

0000000000000010 

0002 


25 

0000000000000100 

0004 


26 

0000000000001000 

0008 


2.7 

0000000000010000 

0010 

•• 

28 

0000000000100000 

0020 


29 

0000000001000000 

0040 


2A 

0000000010000000 

0080 


2B 

0000000100000000 

0100 


2C 

0000001000000000 

0200 


2D 

0000010000000000 

0400 


2E 

0000100000000000 

0800 


2F 

0001000000000000 

1000 


30 

0010000000000000 

2000 


31 

0100000000000000 

4000 


32 

1000000000000000 

8000 

ZROBIT — 

► 33 

1111111111111110 

FFFE 


34 

1111111111111101 

FFFD 


35 

1111111111111011 

FFFB 


36 

1111111111110111 

FFF7 


37 

1111111111101111 

FFEF 


38 

1111111111011111 

FFDF 


39 

1111111110111111 

FFBF 


3A 

1111111101111111 

FF7F 


3B 

1111111011111111 

FEFF 


3C 

1111110111111111 

FDFF 


3D 

1111101111111111 

FBFF 


3E 

1111011111111111 

F7FF 


3F 

1110111111111111 

EFFF 


40 

1101111111111111 

DFFF 


41 

1011111111111111 

BFFF 


42 

0111111111111111 

7FFF 


43 

5 



44 

6 



45 

9 



46 

^16 



47 through B2 

Reserved for process 



B3 

Logical unit number of scratch unit 


B4 

Top of thread of entries in schedule stack 


B5 

Address of FNR 



B6 

Address of COMPRQ 



B7 

Address of mask table 



B8 

Address of top of interrupt stack 



B9 

Address of request exit 



1-2 



Location 


Contents 


HEX Equivalent 


BA 

BB 

BC 

BD 

BE 

BE 

CO 

Cl 

C2 

C3 

C4 


C5 through E3 
E4 
E5 
E6 
E7 
E8 
E9 
EA 
EB 
EC 
ED 
EE 
EE 
EO 
El 
E2 
E3 
E4 
E5 
E6 
E7 
E8 
E9 
EA 
EB 
EC 
ED 
EE 
EE 


Address of volatile storage release routine - VOLR 
Address of volatile storage assignment routine - VOLA 
Address of absolutizing routine for logical unit number 
Address of S absolutizing routine 
Address of C absolutizing routine 
Address of N absolutizing routine 

Most significant bits of first scratch area sector number 
Least significant bits of first scratch area sector number 
Logical unit number of the library unit 

Most significant bits of sector number of first program library di- 
rectory block 

Least significant bits of sector number of first program library 
directory block 

Reserved for EORTRAN (unprotected) 

Used for load and go (unprotected) 

Address of timer handler 
Length of system library directory 

Index to first mass storage entry in the system library directory 

Countdown register 

Real time clock 

Address . of dispatcher 

Address of system library directory 

Temporary highest unprotected location + 1 

Temporary lowest unprotected location - 1 

Used by job processor for returns from loader, etc. 

Current priority level j- PRLVL 
Address of first available volatile storage 
Length of table of presets 
Address of table of presets 

Address of breakpoint program when in core (unprotected) 

Address of entry for system requests (unprotected) 

Highest core location - MAXCOR 
Highest unprotected location + 1 
Lowest improtected location - 1 
Address of internal interrupt processor 
Logical unit number of standard input device 
Logical unit number of standard binary output device 
Logical imit number of standard print output device 
Logical unit number of output comment device 
Logical unit number of input comment device 
Address of the common interrupt handler 
Memory index (unprotected) - I register 


1-3 





INDEX 




r 





INDEX 


absolute addressing 

5-49 

absolute addressing mode 
one-word 
one -word indirect 
two-word 
two-word indirect 

5-7 

5-8 

5-8, 5-52 
5-9 

absolutized program 

11-10, 11-12 

absolutizing addresses 

11-17 

absolutizing programs 

14-5 

adder 

2-6, 5-35 

address expressions 

5-5 

address field 

3-3 

addressing modes 

5-2, 5-13 

allocatable core 

11-1, 11-38, 

11-43, 11-47 

alphanumeric characters 

6-7 

arithmetic 

2-1 

assembler errors 

9-13 

assembler format 

3-2 

assembling a program 

9-2 

automatic restart 

1-3 

backgroimd 8-1, 8- 

-4, 9-1, 11-1 

basic assembler 

6-1 

breakpoint package 

9-17 

buffer data channel 

12-66 

card reader 

12-23 

characteristics of 1700 

1-1 

checksum 

12-9 

checkword, disk 

12-38 

CKASSM program 

8-61 


comment field 3-5 

common block 6-12, 9-6, 11-15 


communications region 

11-1 

completion address 

8-8, 8-16 

conditional assembly 

6-15, 6-18 

configuration 

1-10 

console 

1-11 

constant addressing mode 

5-3, 5-49 

continuator, driver 

13-3 

control statements 


job processor 

9-2, 9-7 

breakpoint 

9-18 

recovery 

9-24 

conversion 

5-45 

core request 

8-55 

core size 

1-1, 1-6 

cylinder 

12-41 

data block 6-12 

, 6-14, 9-5 

debugging 

9-13 

delta 

5-1 

device assignment 

9-7, 9-17 

device failure 

9-15 

direct access channel (1705) 


1-3, 

1-6, 12-36 

disk 

7-12 

dispatcher 11-3, : 

L3-9, 13-13 

drivers 

13-5, 13-9 

drum 

12-48 

entering memory 

1-12 



INDEX (CONT) 


entry points 6-2 

error bit in Q 8-16, 8-17, 8-19 

error checking, peripherals 12-63 

also see error bits on each peripheral 

error section, driver 13-4 

executing a program 9-7 

execution times 

shift class 5-32 

storage reference class 5-32 

exits 8-7, 11-3, 11-30, 11-38 

EXIT request 8-7 

externals 

6-2, 9-5, 11-14, 11-46, 11-49 

floating point numbers 2-7 


input/ output 


interrupts 

7-10, 13-1 

reply or reject 

7-4 

requests 

11-35 

priorities 

11-35 

rejects 

11-37 

status 

7-9, 7-16 

imbuffered 

7-1 

integer numbers 

2-4 

interrupt 


handler, common 


11-3, 13-3, 

13-9, 13-12 

line processor 

13-3, 13-7 

mode programming 

13-1 

stack 

11-3 


system 

1-3, 5-43, 7-10, 11-29, 13-1, 13-7 


flow of program 11-11 

foregroimd 8-1, 8-4, 11-1 

FREAD request 8-8 

function codes 

see specific peripheral 


FWRITE request 

8-8 

GTFILE request 

8-47, 14-3 

hexadecimal numbers 

2-1 

idle loop 

11-3 

indexing 3-4, 5- 

13, 5-15, 5-50 

INDIR request 

8-59, 8-61 

indirect addressing 

5-53 

initiator, driver 

13-1 

instruction classes 

5-1 

inter register instructions 

5-34 

input/ output 

1-6, 5-44, 7-1 

buffered 7-11, 12-36 

1 , 12-48, 12-66 

functions 

7-5, 7-12 


job processor 

jump 

LIBEDT 

libraries 

listing 

load-and-go 

loader blocks 

loader errors 

LOADER request 

loading a program 

9-6, 


9-1 

5-22 

14-1 

11 - 1 , 11-12 
3-5, 3-7 
9-3 
11-6 
9-17 
8-54, 8-55 

9-16, 14-2, 14-7 


location field 3-2 

logical operations 5-21, 5-36, 6-16 
logical xmits 8-19 

low-speed l/ O package 7-3 

M 5-1 


macro assembler 


6-1 



INDEX (CONT) 


macros 

system macros 

6-16, 6-19 
6-19 

magnetic tape 

1731 

1732 

12-57 

12-66 

manual interrupt 

9-1 

mask register 

1-3 

masks 

6-5 

mass memory program coding 

11-42 

mass memory program replacement 

14-1 

mass storage addressing 

8-15, 8-50 

mass storage files 

8-47, 14-5 

mass storage operating system 8-1, 8-4 

memory 

1-1 

memory parity 

5-29 

MONI 

8-2, 8-4 

object program 

11-4 

opcode field 

3-3 

options for assembly (OPT card) 

6-20, 9-3 

overflow 2-7, 

5-24, 5-28 

paper tape punch 

8-11, 12-6 

paper tape reader 7-5, 

8-11, 12-1 

parity bit 

1-2 

physical device tables 

8-44 

power failure 

1-3 

printer 

12-29 

priorities 11-3, 11-24, 

hardware 
I/O requests 

8-28, 8-30 
13-10 


priorities 

mass memory programs 11-47 

schedule requests 11-34 


space 

program library 
protect bit 
protect system 
protected core 
pseudo-ops 
READ request 
real numbers 
record formats 
reentrant coding 
registers 


11-38, 11-43 
11-1, 11-12, 14-3 
1-2 

1-2, 5-29, 5-42 
11-1 
6-1 
8-8 
2-7 
8-10 
11-24 
1-7 


register reference instructions 5-40 


rejects 

input/output requests 11-35, 11-37 
schedule requests 7-4 


release request 


11-40, 11-46 


relative addressing 

5-50, 11-14, 11-17, 11-19 

relative addressing mode 


one-word 5-10, 5-52 

one-word indirect 5-12 

two-word 5-12 

two-word indirect 5-13 

requests 8-1, 11-32 

REQXT 8-2, 8-4 

runanywhere coding 11-12 

buffer addresses 11-17 

externals 11-12 

schedule request 


11-32, 11-44, 8-8, 8-29, 8-36 


11-35, 11-38, 8-9, 8-16 



INDEX (CONT) 


scheduler stack 

11-3 

unprotected core 

11-1 

sector 

12-37 

utility assembler 

6-1 

shift instructions 

5-31, 5-51 

utility system 

8-1, 8-4, 8-5 

short read 

8-17, 8-47 

utopia 

14-9 

skip instructions 

5-26, 5-51 

variable fields 

6-9 

source program 

11-4 

volatile storage 

11-26, 11-28, 11-30 

space request 

11-39, 11-46 

word size 

1-1, 1-2 

STATUS request 

8-42 

WRITE request 

8-8 

status responses 

8-44 




also see specific peripheral 


storage reference addressing mode 5-18 
storage reference instructions 5-18 

storage reservation 6-10 

subroutine parameters 


swappmg core 
sweeping memory 
system initializer 
system library 
system recovery package 
tape 


5-37, 11-29, 11-32 
11-40 
1-13 
14-3, 14-6 
11-1, 11-12, 11-42 
9-17 


see magnetic or 

teletypewriter 

1711/1712 

1713 

thread word 
timer request 
track 

transfer address 
transferring records 
traps for interrupts 


paper 

8-10 

12-11 

12-17 


8-19, 8-28, 11-36 
8-40, 11-34 
12-37 
6-2 
14-7 

1-4, 13-2, 13-7 




